Run an account action
POST/:workspace/accounts/:account/actions/:action
Runs one of the account's actions, from List account actions, on its platform. The request body is the action's input, its fields at the top level. The response is what the action gives back, wrapped in data. Admins and members can run actions; viewers cannot.
list-boards reads the boards from Pinterest, including ones made outside Mixpost, and returns {"boards": [{"id", "name"}]}. create-board creates one and returns {"board": {"id", "name"}}. Both keep the account's boards up to date, so their ids work right away in a post's pinterest.boards option.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
What the action gives back.
The bearer token is missing, malformed, unknown, or expired.
The token is valid, but the user it belongs to may not perform this action:
- they are not a member of the
{workspace}in the path; or - their workspace role is too low for this endpoint (write routes require Admin or Member); or
- for
/panelendpoints, they are not a platform administrator.
The workspace, the account or the action was not found.
The input is invalid, with the errors keyed by field, or the platform refused the action, with its reason as the message. When the platform no longer accepts the account's authorization, the account is marked unauthorized and must be reconnected.
Too many actions: each user can run 30 a minute and each workspace 120, since every action calls the platform on the account's own quota. The Retry-After header says how many seconds to wait.