Skip to main content
POST
/
v1
/
actions
Create an action
curl --request POST \
  --url https://api.fortressproductivity.com/v1/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>"
}
'
{
  "id": "<string>",
  "workspace_id": "<string>",
  "title": "<string>",
  "details": "<string>",
  "project_id": "<string>",
  "domain_id": "<string>",
  "order_id": "<string>",
  "assigned_actor_id": "<string>",
  "assigned_agent_id": "<string>",
  "created_by_actor_id": "<string>",
  "updated_by_actor_id": "<string>",
  "is_template": true,
  "requires_review": true,
  "delegate_label": "<string>",
  "requirements": [
    "<string>"
  ],
  "repeat_rule": {
    "interval": 1
  },
  "defer_until": "2023-11-07T05:31:56Z",
  "due_at": "2023-11-07T05:31:56Z",
  "position": 123,
  "result_summary": "<string>",
  "spawned_from_action_id": "<string>",
  "source_key": "<string>",
  "source_agent_request_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "last_activity_at": "2023-11-07T05:31:56Z",
  "assigned_at": "2023-11-07T05:31:56Z",
  "is_working": true,
  "assigned_actor_name": "<string>",
  "assigned_agent_name": "<string>",
  "created_by_actor_name": "<string>",
  "created_by_agent_id": "<string>",
  "created_by_user_id": "<string>",
  "input_payload": "<unknown>",
  "latest_note": {
    "id": "<string>",
    "workspace_id": "<string>",
    "action_id": "<string>",
    "agent_request_id": "<string>",
    "order_id": "<string>",
    "project_id": "<string>",
    "source_proposal_id": "<string>",
    "created_by_actor_id": "<string>",
    "body": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by_actor_name": "<string>",
    "created_by_agent_id": "<string>",
    "created_by_user_id": "<string>"
  },
  "last_activity_note": {
    "id": "<string>",
    "workspace_id": "<string>",
    "action_id": "<string>",
    "agent_request_id": "<string>",
    "order_id": "<string>",
    "project_id": "<string>",
    "source_proposal_id": "<string>",
    "created_by_actor_id": "<string>",
    "body": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by_actor_name": "<string>",
    "created_by_agent_id": "<string>",
    "created_by_user_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Agent bearer token using the ft_... token format.

Body

application/json
​
title
string
required
Minimum string length: 1
​
details
string | null
​
project_id
string | null
Minimum string length: 1
​
domain_id
string | null
Minimum string length: 1
​
order_id
string | null
Minimum string length: 1
​
assigned_actor_id
string | null
Minimum string length: 1
​
assigned_agent_id
string | null
Minimum string length: 1
​
is_template
boolean
default:false
​
status
enum<string>
default:inbox
Available options:
inbox,
ready,
waiting,
done,
dropped
​
requires_review
boolean
default:true
​
delegate_label
string | null
​
requirements
string[]
​
repeat_rule
object
​
defer_until
string<date-time> | null
​
due_at
string<date-time> | null
​
position
integer | null
​
input_payload
any
​
spawned_from_action_id
string | null
Minimum string length: 1
​
source_key
string | null
Minimum string length: 1
​
permitted_proposal_id
string
Minimum string length: 1
​
links
object[]

Response

Created action

​
id
string
required
Minimum string length: 1
​
workspace_id
string
required
Minimum string length: 1
​
title
string
required
Minimum string length: 1
​
details
string | null
required
​
project_id
string | null
required
Minimum string length: 1
​
domain_id
string | null
required
Minimum string length: 1
​
order_id
string | null
required
Minimum string length: 1
​
assigned_actor_id
string | null
required
Minimum string length: 1
​
assigned_agent_id
string | null
required
Minimum string length: 1
​
created_by_actor_id
string
required
Minimum string length: 1
​
updated_by_actor_id
string
required
Minimum string length: 1
​
is_template
boolean
required
​
status
enum<string>
required
Available options:
inbox,
ready,
waiting,
done,
dropped
​
requires_review
boolean
required
​
delegate_label
string | null
required
​
requirements
string[]
required
​
repeat_rule
object
required
​
defer_until
string<date-time> | null
required
​
due_at
string<date-time> | null
required
​
position
integer | null
required
​
result_summary
string | null
required
​
spawned_from_action_id
string | null
required
Minimum string length: 1
​
source_key
string | null
required
Minimum string length: 1
​
source_agent_request_id
string | null
required
Minimum string length: 1
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
completed_at
string<date-time> | null
required
​
last_activity_at
string<date-time>
required
​
assigned_at
string<date-time> | null
required
​
is_working
boolean
required
​
assigned_actor_kind
enum<string> | null
Available options:
user,
agent,
system,
null
​
assigned_actor_name
string | null
​
assigned_agent_name
string | null
​
created_by_actor_kind
enum<string> | null
Available options:
user,
agent,
system,
null
​
created_by_actor_name
string | null
​
created_by_agent_id
string | null
Minimum string length: 1
​
created_by_user_id
string | null
Minimum string length: 1
​
input_payload
any
​
latest_note
object
​
last_activity_note
object