Pular navegação
Base de conhecimento

Projetos e pastas

Estrutura do workspace para organizar conteúdo.

Projects

O objeto projeto

CampoTipoDescrição
idstringIdentificador único do objeto.
namestringNome do projeto
folders[]FolderLista de pastas do projeto
created_atdatetime
updated_atdatetime

Criar projeto

POST {{baseHost}}/v1/projects

Cria um projeto. Em caso de sucesso, retorna o objeto criado.

Criar um projeto

CampoTipoDescrição
namestringobrigatório
privacy_typestringobrigatório
privacy_domains[]stringobrigatório
player_iduuidnão obrigatório
encryptedbooleannão obrigatório
catalog_typestringvod ou live
Request body (json)
{  "name": "Project custom",  "privacy_type": "custom",  "privacy_domains": [    "custom.domain.com"  ],  "player_id": "...",  "encrypted": false,  "catalog_type": "vod"}

Lista de projetos

GET {{baseHost}}/v1/projects

Retorna a lista de projetos. Os resultados são paginados e podem ser filtrados por parâmetros de consulta.

Responses
{ "meta": {  "pagination": {   "page": 1,   "per_page": 100,   "total": 34  },  "order": {"name":"asc"} }, "data": [  {   "id": "<UUID>",   "name": "111",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 38927956038,   "items_count": 122,   "created_at": "2022-11-08T13:32:22.466173Z",   "updated_at": "2026-04-14T20:17:43.725423Z",   "encrypted": true  },  {   "id": "<UUID>",   "name": "A-test",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 0,   "items_count": 0,   "created_at": "2026-04-03T11:48:48.599771Z",   "updated_at": "2026-04-13T14:19:33.919518Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "chat_history_forward_link_bug",   "folders": [    {     "id": "<UUID>",     "name": "  ",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 1723003012,     "items_count": 2,     "created_at": "2026-04-21T16:20:59.711708Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 13277281933,   "items_count": 4,   "created_at": "2026-03-20T14:32:08.589836Z",   "updated_at": "2026-04-13T14:19:32.35553Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "Clearkey",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 5932541497,   "items_count": 10,   "created_at": "2024-09-25T06:55:35.484068Z",   "updated_at": "2026-04-03T12:24:59.524157Z",   "encrypted": true  },  {   "id": "<UUID>",   "name": "Codec Samples",   "folders": [    {     "id": "<UUID>",     "name": "AV1",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 120194940,     "items_count": 9,     "created_at": "2025-07-23T18:47:00.409285Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "H264",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 151215623,     "items_count": 6,     "created_at": "2025-07-23T15:16:26.447068Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "HEVC",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 122554144,     "items_count": 9,     "created_at": "2025-07-23T15:29:28.890618Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "VP9",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 208857361,     "items_count": 9,     "created_at": "2025-07-23T15:08:12.764331Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 614998534,   "items_count": 34,   "created_at": "2025-07-23T15:00:22.560116Z",   "updated_at": "2026-04-03T18:46:13.017069Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "encr",   "folders": [    {     "id": "<UUID>",     "name": "123",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 372110777,     "items_count": 1,     "created_at": "2026-04-13T08:47:27.759934Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 372110777,   "items_count": 1,   "created_at": "2026-01-22T14:37:32.142745Z",   "updated_at": "2026-04-03T07:11:48.452395Z",   "encrypted": true  },  {   "id": "<UUID>",   "name": "Encrypted",   "folders": [    {     "id": "<UUID>",     "name": "New folder",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 53543990,     "items_count": 4,     "created_at": "2022-09-27T13:53:53.850129Z",     "updated_at": "2025-12-03T17:30:08.24509Z",     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 36641090232,   "items_count": 74,   "created_at": "2022-05-30T13:15:49.351933Z",   "updated_at": "2026-04-03T07:11:46.900705Z",   "encrypted": true  },  {   "id": "<UUID>",   "name": "Livekit",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 5715708552,   "items_count": 60,   "created_at": "2024-08-07T11:57:53.631918Z",   "updated_at": "2024-11-13T08:36:09.921481Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "Meetings",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [    "druzh.ru"   ],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 4260648813,   "items_count": 63,   "created_at": "2024-09-24T12:30:07.300799Z",   "updated_at": "2025-05-05T18:17:43.426001Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "My first project2",   "folders": [    {     "id": "<UUID>",     "name": "Test",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 0,     "items_count": 0,     "created_at": "2022-06-01T06:40:41.77392Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "Vídeos para sites de teste",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 1989379249,     "items_count": 2,     "created_at": "2021-11-29T15:25:12.484474Z",     "updated_at": "2022-01-20T09:32:21.838166Z",     "deleted_at": null    },    {     "id": "<UUID>",     "name": "nova pasta",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 742749555,     "items_count": 14,     "created_at": "2022-04-12T22:21:43.405874Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "pasta de teste",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 18402007828,     "items_count": 10,     "created_at": "2021-02-08T10:35:42.310194Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "nowhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 207273768257,   "items_count": 339,   "created_at": "2020-09-16T22:01:05.18814Z",   "updated_at": "2025-12-24T14:15:41.832531Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "New project Restream Speak",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 0,   "items_count": 0,   "created_at": "2025-05-26T14:10:17.55122Z",   "updated_at": "2026-04-01T07:13:47.243006Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "Restream VOD",   "folders": [],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 556115506,   "items_count": 4,   "created_at": "2022-11-15T21:06:28.691855Z",   "updated_at": null,   "encrypted": false  },  {   "id": "<UUID>",   "name": "Speak Records",   "folders": [    {     "id": "<UUID>",     "name": "New folder",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 1846701232,     "items_count": 2,     "created_at": "2026-04-13T08:46:21.785564Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 58643200289,   "items_count": 216,   "created_at": "2025-06-25T12:08:14.268278Z",   "updated_at": null,   "encrypted": false  },  {   "id": "<UUID>",   "name": "subtitles",   "folders": [    {     "id": "<UUID>",     "name": "New folder",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 578021274,     "items_count": 3,     "created_at": "2026-04-22T08:11:00.588416Z",     "updated_at": null,     "deleted_at": null    }   ],   "privacy_type": "anywhere",   "privacy_domains": [],   "privacy_email_domains": [],   "privacy_share": {    },   "player_id": "<UUID>",   "favorite": false,   "size": 578021274,   "items_count": 1,   "created_at": "2026-02-04T11:15:27.858112Z",   "updated_at": "2026-04-13T14:19:39.710022Z",   "encrypted": false  },  {   "id": "<UUID>",   "name": "Test",   "folders": [    {     "id": "<UUID>",     "name": "3",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 1519538159,     "items_count": 2,     "created_at": "2023-01-23T10:55:32.210786Z",     "updated_at": null,     "deleted_at": null    },    {     "id": "<UUID>",     "name": "111",     "project_id": "<UUID>",     "parent_id": "<UUID>",     "size": 1494193183,     "items_count": 2,     "created_at": "2024-10-20T09:43:22.606387Z",     "updated_at": null,     "deleted_at": null// … truncated

Obter projeto

GET {{baseHost}}/v1/projects/:project_id

Retorna os dados de um projeto pelo seu identificador único.

Responses
{  "data": {    "id": "<UUID>",    "name": "chat_history_forward_link_bug",    "folders": [      {        "id": "<UUID>",        "name": "  ",        "project_id": "<UUID>",        "parent_id": "<UUID>",        "size": 1723003012,        "items_count": 2,        "created_at": "2026-04-21T16:20:59.711708Z",        "updated_at": null,        "deleted_at": null      }    ],    "privacy_type": "anywhere",    "privacy_domains": [],    "privacy_email_domains": [],    "privacy_share": {},    "player_id": "<UUID>",    "favorite": false,    "size": 13277281933,    "items_count": 4,    "created_at": "2026-03-20T14:32:08.589836Z",    "updated_at": "2026-04-13T14:19:32.35553Z",    "encrypted": false  }}
{  "error": {    "code": 400404,    "message": "not found"  }}

Excluir projeto

DELETE {{baseHost}}/v1/projects/:project_id

Exclui o projeto permanentemente. A ação não pode ser desfeita.

Atualizar projeto

PUT {{baseHost}}/v1/projects/:project_id

Atualiza o projeto indicado. Só os campos enviados no corpo da requisição são alterados; os demais ficam como estão.

Request body (json)
{  "name": "Project name updated",  "privacy_type": "anywhere",  "privacy_domains": [],  "apply_to_videos": false,  "player_id": "..."}
Responses
{  "data": {    "id": "<UUID>",    "name": "Project name updated",    "folders": [      {        "id": "<UUID>",        "name": "New folder",        "project_id": "<UUID>",        "created_at": "2020-08-31T10:14:28.422193Z",        "updated_at": null,        "deleted_at": null      }    ],    "created_at": "2020-06-04T21:08:35.432107Z",    "updated_at": "2020-08-31T10:15:09.685516Z"  }}

Folders

O objeto pasta

CampoTipoDescrição
idstringIdentificador único do objeto.
namestringNome da pasta
project_idstring
created_atdatetime
updated_atdatetime

Criar pasta

POST {{baseHost}}/v1/projects/:project_id/folders

Cria uma pasta. Em caso de sucesso, retorna o objeto criado.

Request body (json)
{  "name": "Nova pasta 1",  "parent_id": "<UUID>"}
Responses
{  "data": {    "id": "spuavLLtW44iUmHbL75z2u",    "name": "Nova pasta",    "project_id": "mNFQz2wYTBhLkPBCo9oS8m",    "created_at": "2020-08-31T10:14:28.422193Z",    "updated_at": null,    "deleted_at": null  }}

Lista de pastas

GET {{baseHost}}/v1/projects/:project_id/folders

Retorna a lista de pastas. Os resultados são paginados e podem ser filtrados por parâmetros de consulta.

Responses
{  "meta": {    "pagination": {      "page": 1,      "per_page": 10,      "total": 1    },    "order": {      "created_at": "desc"    }  },  "data": [    {      "id": "<UUID>",      "name": "  ",      "project_id": "<UUID>",      "parent_id": "<UUID>",      "size": 1723003012,      "items_count": 2,      "created_at": "2026-04-21T16:20:59.711708Z",      "updated_at": null,      "deleted_at": null    }  ]}

Obter pasta

GET {{baseHost}}/v1/projects/:project_id/folders/:folder_id

Retorna os dados de uma pasta pelo seu identificador único.

Responses
{  "data": {    "id": "<UUID>",    "name": "  ",    "project_id": "<UUID>",    "parent_id": "<UUID>",    "size": 1723003012,    "items_count": 2,    "created_at": "2026-04-21T16:20:59.711708Z",    "updated_at": null,    "deleted_at": null  }}
{  "error": {    "code": 400404,    "message": "not found"  }}

Atualizar pasta

PUT {{baseHost}}/v1/projects/:project_id/folders/:folder_id

Atualiza a pasta indicada. Só os campos enviados no corpo da requisição são alterados; os demais ficam como estão.

Request body (json)
{  "name": "Nova pasta atualizada"}
Responses
{  "data": {    "id": "spuavLLtW44iUmHbL75z2u",    "name": "Nova pasta atualizada",    "project_id": "mNFQz2wYTBhLkPBCo9oS8m",    "created_at": "2020-08-31T10:14:28.422193Z",    "updated_at": "2020-08-31T10:16:24.737994Z",    "deleted_at": null  }}

Excluir pasta

DELETE {{baseHost}}/v1/projects/:project_id/folders/:folder_id

Exclui a pasta permanentemente. A ação não pode ser desfeita.

Responses
{  "data": {    "id": "spuavLLtW44iUmHbL75z2u",    "name": "Nova pasta",    "project_id": "mNFQz2wYTBhLkPBCo9oS8m",    "created_at": "2020-08-31T10:14:28.422193Z",    "updated_at": null,    "deleted_at": null  }}