​
Get card file
GET
https://example.kaiten.ru/api/latest/cards/{card_uid}/files/{id}Returns file metadata together with a signed URL. Pass redirect=true to get a redirect to the file instead, download=true to force a download.
| Name | Type | Reference |
|---|---|---|
| card_uidrequired | string (uuid) | Card UID |
| idrequired | string (uuid) | File UID |
| Name | Value | Description |
|---|---|---|
| Authorizationrequired | Bearer <token> | API token is required |
| Name | Type | Constraints | Description |
|---|---|---|---|
| redirect | boolean | If true, the server responds with a 302 redirect to the signed file URL instead of the JSON metadata | |
| download | boolean | If true, the signed file URL serves the file with Content-Disposition: attachment |
Responses
| Description | Response type | Example |
|---|---|---|
| Success | Object |
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | File UID |
| name | string | File name |
| size | null | string (bigint) | File size in bytes |
| mime_type | string (mime-type) | MIME type |
| entity_type | string | File entity type, always card |
| created | string (date-time) | Creation date and time |
| updated | string (date-time) | Last update date and time |
| card_uid | string (uuid) | Card UID |
| author_uid | string (uuid) | Author UID |
| card_cover | boolean | Flag indicating that image is used as card cover |
| url | string (uri) | Temporary signed URL to the file content. Images, videos and PDF files are served inline, other types as an attachment; with download=true always as an attachment. The URL expires shortly, request the file again instead of caching it |
| Description | Response type | Example |
|---|---|---|
| Success | Redirect | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Not found | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| The file is malicious | Object | Response body does not exist |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
Kaiten
If you have any questions or need help with integration feel free to write us at support@kaiten.ru
Path Parameters
1 curl --request GET \
2 --url 'https://example.kaiten.ru/api/latest/cards/{card_uid}/files/{id}' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!