Sign in

v6

latestOpenAPI 3.1.02026-08-047720752.5 KB
Files

Create a folder

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.

post/v2/files

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"
  }
}