ATattio
Tasks

Create a task

Changed on

Creates a new task.

At present, tasks can only be created from plaintext without record reference formatting.

Required scopes: task:read-write, object_configuration:read, record_permission:read, user_management:read.

Supported token levels: workspace, user.

post/v2/tasks

Request

  • Base URL
    https://api.attio.com
  • URL
    https://api.attio.com/v2/tasks
  • Auth
    OAuth 2
    Authorization code: https://app.attio.com/authorize
    Token URL: https://app.attio.com/oauth/token scopes: task:read-write, object_configuration:read, record_permission:read, user_management:read

Request body

Example request

{
  "data": {
    "content": "Follow up on current software solutions",
    "deadline_at": "2023-01-01T15:00:00.000000000Z",
    "linked_records": [
      "person@company.com",
      "fundstack.com"
    ],
    "assignees": [
      {
        "referenced_actor_type": "workspace-member",
        "referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
      }
    ]
  }
}

Response

Success

Example response

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "task_id": "649e34f4-c39a-4f4d-99ef-48a36bef8f04"
    },
    "content_plaintext": "Follow up on current software solutions",
    "deadline_at": "2023-01-01",
    "completed_at": "2022-11-21T13:22:49.061281000Z",
    "linked_records": [
      {
        "target_object_id": "people",
        "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "assignees": [
      {
        "referenced_actor_type": "workspace-member",
        "referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
      }
    ],
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

Changes

  • 1a3c214e1a13Revision changes
    • breaking

      the response's property type changed from string to no type for status

    • info

      added subschema #1 subschema #2 to the response property anyOf list for the response status

    • info

      removed the validation_type enum value from the response property for the response status

  • 5b8daba4e18cRevision changes
    • info

      added subschema #1 subschema #2 to the / request property anyOf list

    • info

      added the required property / to the response with the status