plan-approvals

Create approval requests for a content plan

POST

https://mcp.socialneuron.com/v1

/tools/create_plan_approvals

Create approval requests for a content plan › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

object[] · minItems: 1 · required

Posts to create approval entries for.

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID. Defaults to active project context.

response_format

string · enum

Enum values:

text

json

Create approval requests for a content plan › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/create_plan_approvals

curl https://mcp.socialneuron.com/v1/tools/create_plan_approvals \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "plan_id": "00000000-0000-0000-0000-000000000000",
  "posts": [
    {
      "id": "id",
      "platform": "platform",
      "caption": "caption",
      "title": "title",
      "media_url": "media_url",
      "schedule_at": "schedule_at"
    }
  ],
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "plan_id": "00000000-0000-0000-0000-000000000000",
  "posts": [
    {
      "id": "id",
      "platform": "platform",
      "caption": "caption",
      "title": "title",
      "media_url": "media_url",
      "schedule_at": "schedule_at"
    }
  ],
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

Respond to a plan approval request

POST

https://mcp.socialneuron.com/v1

/tools/respond_plan_approval

Respond to a plan approval request › Request Body

approval_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Approval item ID

decision

string · enum · required

Enum values:

approved

rejected

edited

object

reason

string · maxLength: 1000

response_format

string · enum

Enum values:

text

json

Respond to a plan approval request › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/respond_plan_approval

curl https://mcp.socialneuron.com/v1/tools/respond_plan_approval \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "approval_id": "00000000-0000-0000-0000-000000000000",
  "decision": "approved",
  "edited_post": {
    "key": {}
  },
  "reason": "reason",
  "response_format": "text"
}'

Example Request Body

{
  "approval_id": "00000000-0000-0000-0000-000000000000",
  "decision": "approved",
  "edited_post": {
    "key": {}
  },
  "reason": "reason",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

List pending plan approval requests

POST

https://mcp.socialneuron.com/v1

/tools/list_plan_approvals

List pending plan approval requests › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

status

string · enum

Enum values:

pending

approved

rejected

edited

response_format

string · enum

Enum values:

text

json

List pending plan approval requests › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

pipeline planning

Social Neuron REST API

plan-approvals

Create approval requests for a content plan

POST

https://mcp.socialneuron.com/v1

/tools/create_plan_approvals

Create approval requests for a content plan › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

object[] · minItems: 1 · required

Posts to create approval entries for.

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID. Defaults to active project context.

response_format

string · enum

Enum values:

text

json

Create approval requests for a content plan › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/create_plan_approvals

curl https://mcp.socialneuron.com/v1/tools/create_plan_approvals \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "plan_id": "00000000-0000-0000-0000-000000000000",
  "posts": [
    {
      "id": "id",
      "platform": "platform",
      "caption": "caption",
      "title": "title",
      "media_url": "media_url",
      "schedule_at": "schedule_at"
    }
  ],
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "plan_id": "00000000-0000-0000-0000-000000000000",
  "posts": [
    {
      "id": "id",
      "platform": "platform",
      "caption": "caption",
      "title": "title",
      "media_url": "media_url",
      "schedule_at": "schedule_at"
    }
  ],
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

Respond to a plan approval request

POST

https://mcp.socialneuron.com/v1

/tools/respond_plan_approval

Respond to a plan approval request › Request Body

approval_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Approval item ID

decision

string · enum · required

Enum values:

approved

rejected

edited

object

reason

string · maxLength: 1000

response_format

string · enum

Enum values:

text

json

Respond to a plan approval request › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

POST/tools/respond_plan_approval

curl https://mcp.socialneuron.com/v1/tools/respond_plan_approval \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "approval_id": "00000000-0000-0000-0000-000000000000",
  "decision": "approved",
  "edited_post": {
    "key": {}
  },
  "reason": "reason",
  "response_format": "text"
}'

Example Request Body

{
  "approval_id": "00000000-0000-0000-0000-000000000000",
  "decision": "approved",
  "edited_post": {
    "key": {}
  },
  "reason": "reason",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

List pending plan approval requests

POST

https://mcp.socialneuron.com/v1

/tools/list_plan_approvals

List pending plan approval requests › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

status

string · enum

Enum values:

pending

approved

rejected

edited

response_format

string · enum

Enum values:

text

json

List pending plan approval requests › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

ToolResult

object[]

object

isError

boolean

pipeline planning