Pular navegação
Base de conhecimento

Solicitações de arquivo

Receba arquivos de usuários externos.

File requests

Criar solicitação de arquivo

POST https://api.kinescope.io/v1/file-requests

Cria uma solicitação de arquivo. Em caso de sucesso, retorna o objeto criado.

CampoTipoDescrição
titlestringTítulo da solicitação.
descriptionstringDescrição livre exibida a quem envia os arquivos.
uploading_location_iduuidProjeto ou pasta onde os arquivos enviados vão parar.
expired_atdatetime, nullableQuando a solicitação para de aceitar envios. null — sem prazo.
Request body (json)
{
  "title": "Título",
  "description": "Descrição",
  "uploading_location_id": "aUXVrK41BmeNVwyxQ4at6x",
  "expired_at": null
}
Responses
{
  "data": {
    "id": "4LPmdVVrEVvRBZWh4uAV6K",
    "workspace_id": "jjGZ6gbAhANmv461rR9MSM",
    "title": "Título",
    "description": "Descrição",
    "uploading_location_id": "aUXVrK41BmeNVwyxQ4at6x",
    "expired_at": null,
    "created_by": null,
    "created_at": "2021-11-10T16:08:00.086941Z",
    "updated_at": null,
    "archived_at": null,
    "user_count": 0,
    "media_count": 0
  }
}

Listar solicitações de arquivo

GET https://api.kinescope.io/v1/file-requests

Retorna a lista de solicitações de arquivo. Os resultados são paginados e podem ser filtrados por parâmetros de consulta.

Responses
{
  "meta": {
    "offset": 0,
    "limit": 10,
    "total": 7,
    "total_count": 0,
    "order": {
      "title": "asc"
    },
    "parent_id": null
  },
  "data": [
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "test",
      "description": "",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2024-11-15T07:39:16.772084Z",
      "updated_at": null,
      "archived_at": null,
      "user_count": 2,
      "media_count": 3,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "Título de exemplo",
      "description": "Descrição de exemplo",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2025-11-20T09:04:12.850561Z",
      "updated_at": null,
      "archived_at": null,
      "user_count": 1,
      "media_count": 1,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "Para o palestrante número um",
      "description": "enviamos arquivos para uma pasta específica",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2021-11-11T19:10:23.209681Z",
      "updated_at": "2022-03-24T13:20:20.317128Z",
      "archived_at": null,
      "user_count": 10,
      "media_count": 13,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "Título provisório",
      "description": "Descrição provisória",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2024-09-12T07:39:47.404116Z",
      "updated_at": null,
      "archived_at": null,
      "user_count": 0,
      "media_count": 0,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "teste",
      "description": "",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2024-05-28T09:24:08.291024Z",
      "updated_at": null,
      "archived_at": null,
      "user_count": 0,
      "media_count": 0,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "teste",
      "description": "",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2022-01-21T15:10:25.15006Z",
      "updated_at": null,
      "archived_at": null,
      "user_count": 0,
      "media_count": 0,
      "url": "https://kinescope.io/request/<UUID>"
    },
    {
      "id": "<UUID>",
      "workspace_id": "<UUID>",
      "title": "Teste 2",
      "description": "",
      "uploading_location_id": "<UUID>",
      "expired_at": null,
      "created_by": "Example User",
      "created_at": "2022-01-21T15:51:37.351205Z",
      "updated_at": "2023-11-16T13:06:05.528159Z",
      "archived_at": null,
      "user_count": 1,
      "media_count": 3,
      "url": "https://kinescope.io/request/<UUID>"
    }
  ]
}

Obter solicitação de arquivo

GET https://api.kinescope.io/v1/file-requests/:file_request_id

Retorna os dados de uma solicitação de arquivo pelo seu identificador único.

Responses
{
  "data": {
    "id": "<UUID>",
    "workspace_id": "<UUID>",
    "title": "test",
    "description": "",
    "uploading_location_id": "<UUID>",
    "expired_at": null,
    "created_by": "Example User",
    "created_at": "2024-11-15T07:39:16.772084Z",
    "updated_at": null,
    "archived_at": null,
    "user_count": 2,
    "media_count": 3,
    "url": "https://kinescope.io/request/<UUID>"
  }
}
{
  "error": {
    "code": 400404,
    "message": "not found"
  }
}

Atualizar solicitação de arquivo

PUT https://api.kinescope.io/v1/file-requests/:file_request_id

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

CampoTipoDescrição
titlestringTítulo da solicitação.
descriptionstringDescrição livre exibida a quem envia os arquivos.
uploading_location_iduuidProjeto ou pasta onde os arquivos enviados vão parar.
expired_atdatetime, nullableQuando a solicitação para de aceitar envios. null — sem prazo.
Request body (json)
{
  "title": "Rename request",
  "uploading_location_id": "eR9N13hPU2vynDwJxrwoyP",
  "expired_at": null,
  "archived": false
}
Responses
{
  "data": {
    "id": "nmy77cZuc1TABAUZHCfoms",
    "workspace_id": "4yE327XRe7zqfXe4doV7mu",
    "name": "Rename request",
    "uploading_location_id": "eR9N13hPU2vynDwJxrwoyP",
    "expired_at": null,
    "created_at": "2021-11-06T14:23:07.466584Z",
    "updated_at": "2021-11-06T15:19:33.767551Z",
    "archived_at": null,
    "user_count": 0,
    "media_count": 0
  }
}

Excluir solicitação de arquivo

DELETE https://api.kinescope.io/v1/file-requests/:file_request_id

Exclui a solicitação de arquivo permanentemente. A ação não pode ser desfeita.

Responses
{
  "data": {
    "success": true
  }
}