ATattio
Files

Create a folder

Changed on

Creates a native folder entry or a connected file/folder entry on an object record.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: file:read-write, object_configuration:read, record_permission:read.

Supported token levels: workspace, user.

post/v2/files

Request

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

Request body

OR
OR

Example request

{
  "object": "people",
  "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b",
  "name": "Documents",
  "parent_folder_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response

Success

Example response

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "file_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
    "object_slug": "people",
    "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b",
    "storage_provider": "attio",
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    },
    "created_at": "2023-01-01T15:00:00.000000000Z",
    "name": "Documents"
  }
}

Changes