File Endpoints

GET /files

Fetch all files stored on Cumulonimbus.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_READ_FILES scope.

Parameters

Name	Type	Location	Required	Description
`limit`	number	query	No	The maximum number of files to return. The default and maximum value is 50
`offset`	number	query	No	The offset to start from when returning files. The default value is 0

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/files?limit=5&offset=0"

fetch('https://alekeagle.me/api/files?limit=5&offset=0', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- List<File>
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

GET /users/:uid/files

Fetch files owned by the specified user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_READ_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID.
`limit`	number	query	No	The maximum number of files to return. The default and maximum value is 50
`offset`	number	query	No	The offset to start from when returning files. The default value is 0

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/1234567890123/files?limit=5&offset=0"

fetch('https://alekeagle.me/api/users/1234567890123/files?limit=5&offset=0', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- List<File>
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidUser
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

GET /users/me/files

Fetch files owned by the authenticated user.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_READ scope.

Parameters

Name	Type	Location	Required	Description
`limit`	number	query	No	The maximum number of files to return. The default and maximum value is 50
`offset`	number	query	No	The offset to start from when returning files. The default value is 0

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/me/files?limit=5&offset=0&uid=me"

fetch('https://alekeagle.me/api/users/me/files?limit=5&offset=0&uid=me', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- List<File>
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

GET /files/:id

Arbitrarily fetch a file by its ID, regardless of ownership.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_READ_FILES scope.

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/files/abcdefghij.png"

fetch('https://alekeagle.me/api/files/abcdefghij.png', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- File
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

GET /users/:uid/files/:id

Fetch a file owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_READ_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png"

fetch('https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- File
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

GET /users/me/files/:id

Fetch a file owned by the authenticated user.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_READ scope.

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X GET \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/me/files/abcdefghij.png"

fetch('https://alekeagle.me/api/users/me/files/abcdefghij.png', {
  method: 'GET',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- File
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

PUT /users/:uid/files/:id/name

Update a file's display name that is owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`id`	string	path	Yes	The file ID
`name`	string	body	Yes	The new display name

Example Requests

cURLJS Fetch

curl -X PUT \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"name": "My File"}' \
"https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/name"

fetch(
  'https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/name',
  {
    method: 'PUT',
    headers: {
      'Authorization':
        'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'My File',
    }),
  },
);

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

PUT /users/me/files/:id/name

Update a file's display name that is owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_MODIFY(6)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_MODIFY scope.

Ratelimit

This endpoint uses a ratelimit that is separate from the rest of the API. This ratelimit is 20 requests per hour per user. Requests that are responded to with error code 500 Internal Server Error are not counted towards this ratelimit.

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID
`name`	string	body	Yes	The new display name

Example Requests

cURLJS Fetch

curl -X PUT \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"name": "My File"}' \
"https://alekeagle.me/api/users/me/files/abcdefghij.png/name"

fetch('https://alekeagle.me/api/users/me/files/abcdefghij.png/name', {
  method: 'PUT',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'My File',
  }),
});

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/:uid/files/:id/name

Delete a file's display name that is owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/name"

fetch(
  'https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/name',
  {
    method: 'DELETE',
    headers: {
      Authorization:
        'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    },
  },
);

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/me/files/:id/name

Delete a file's display name that is owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_MODIFY(6)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_MODIFY scope.

Ratelimit

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/me/files/abcdefghij.png/name"

fetch('https://alekeagle.me/api/users/me/files/abcdefghij.png/name', {
  method: 'DELETE',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

PUT /users/:uid/files/:id/extension

Update a file's extension that is owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Warning

Since the file extension is part of the file's ID, changing the extension will change the file's ID. This means that any links to the file will no longer work.

Note

When a file's extension is changed, it is logged to the server's logs, that way staff can use this information to help improve the file type detection.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`id`	string	path	Yes	The file ID
`extension`	string	body	Yes	The new file extension

Example Requests

cURLJS Fetch

curl -X PUT \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"extension": "png"}' \
"https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/extension"

fetch(
  'https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png/extension',
  {
    method: 'PUT',
    headers: {
      'Authorization':
        'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      extension: 'png',
    }),
  },
);

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

PUT /users/me/files/:id/extension

Update a file's extension that is owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_MODIFY(6)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_MODIFY scope.

Warning

Since the file extension is part of the file's ID, changing the extension will change the file's ID. This means that any links to the file will no longer work.

Note

When a file's extension is changed, it is logged to the server's logs, that way staff can use this information to help improve the file type detection.

Ratelimit

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID
`extension`	string	body	Yes	The new file extension

Example Requests

cURLJS Fetch

curl -X PUT \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"extension": "png"}' \
"https://alekeagle.me/api/users/me/files/abcdefghij.png/extension"

fetch('https://alekeagle.me/api/users/me/files/abcdefghij.png/extension', {
  method: 'PUT',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    extension: 'png',
  }),
});

Responses

200 OK
- File
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/:uid/files/:id

Delete a file owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png"

fetch('https://alekeagle.me/api/users/1234567890123/files/abcdefghij.png', {
  method: 'DELETE',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- DeleteFile
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/me/files/:id

Delete a file owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_DELETE(7)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_MODIFY scope.

Parameters

Name	Type	Location	Required	Description
`id`	string	path	Yes	The file ID

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
"https://alekeagle.me/api/users/me/files/abcdefghij.png"

fetch('https://alekeagle.me/api/users/me/files/abcdefghij.png', {
  method: 'DELETE',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
});

Responses

200 OK
- DeleteFile
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/:uid/files

Delete multiple files owned by a specific user.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID
`ids`	string	body	Yes	The file IDs

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"ids":["abcdefghij.png","klmnopqrst.png"]}' \
"https://alekeagle.me/api/users/1234567890123/files"

fetch('https://alekeagle.me/api/users/1234567890123/files', {
  method: 'DELETE',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ids: ['abcdefghij.png', 'klmnopqrst.png'],
  }),
});

Responses

200 OK
- DeleteFiles
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/me/files

Delete multiple files owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_DELETE(7)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the FILE_MODIFY scope.

Ratelimit

This endpoint uses a ratelimit that is separate from the rest of the API. This ratelimit is 20 requests per 6 hours per user. Requests that are responded to with error codes 400 Bad Request, 404 Not Found, and 500 Internal Server Error are not counted towards this ratelimit.

Parameters

Name	Type	Location	Required	Description
`ids`	string	body	Yes	The file IDs

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"ids":["abcdefghij.png","klmnopqrst.png"]}' \
"https://alekeagle.me/api/users/me/files"

fetch('https://alekeagle.me/api/users/me/files', {
  method: 'DELETE',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ids: ['abcdefghij.png', 'klmnopqrst.png'],
  }),
});

Responses

200 OK
- DeleteFiles
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /files

Arbitrarily delete a list of files by ID, regardless of ownership.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the STAFF_MODIFY_FILES scope.

Parameters

Name	Type	Location	Required	Description
`ids`	string	body	Yes	The file IDs

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"ids":["abcdefghij.png","klmnopqrst.png"]}' \
"https://alekeagle.me/api/files"

fetch('https://alekeagle.me/api/files', {
  method: 'DELETE',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ids: ['abcdefghij.png', 'klmnopqrst.png'],
  }),
});

Responses

200 OK
- DeleteFiles
401 Unauthorized
- InvalidSession
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidFile
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal

DELETE /users/:uid/files/all

Deletes all files owned by the user specified.

Non-Public Endpoint

This endpoint is not public and requires authentication of a user with staff permissions.

Scoped Session

Requests to this endpoint using a scoped session are not allowed in order to prevent mass deletion of files without explicit user consent.

Identity Reverification

This endpoint will require you to provide your password to confirm it's you. More information can found in the Identity Reverification section.

Parameters

Name	Type	Location	Required	Description
`uid`	string	path	Yes	The User's ID.

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"password":"password"}' \
"https://alekeagle.me/api/users/1234567890123/files/all"

fetch('https://alekeagle.me/api/users/1234567890123/files/all', {
  method: 'DELETE',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    password: 'password',
  }),
});

Responses

200 OK
- DeleteFiles
401 Unauthorized
- InvalidSession
- InvalidPassword
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidUser
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

DELETE /users/me/files/all

Deletes all files owned by the authenticated user.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_DELETE(7)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session are not allowed in order to prevent mass deletion of files without explicit user consent.

Identity Reverification

This endpoint will require you to provide your password to confirm it's you. More information can found in the Identity Reverification section.

Ratelimit

This endpoint uses a ratelimit that is separate from the rest of the API. This ratelimit is 1 request per 7 days per user. Requests that are responded to with error codes 404 Not Found, and 500 Internal Server Error are not counted towards this ratelimit.

Parameters

There are no parameters for this endpoint.

Example Requests

cURLJS Fetch

curl -X DELETE \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-H "Content-Type: application/json" \
-d '{"password":"password"}' \
"https://alekeagle.me/api/users/me/files/all"

fetch('https://alekeagle.me/api/users/me/files/all', {
  method: 'DELETE',
  headers: {
    'Authorization':
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    password: 'password',
  }),
});

Responses

200 OK
- DeleteFiles
401 Unauthorized
- InvalidSession
- InvalidPassword
403 Forbidden
- Banned
- InsufficientPermissions
404 Not Found
- InvalidUser
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

POST /upload

Uploads a file to the server.

Kill Switch Behavior

This endpoint is affected by the following kill switches:

FILE_CREATE(5)

and will fail with the error ServiceUnavailable if any of these kill switches are enabled.

Scoped Session

Requests to this endpoint using a scoped session require the session to have the UPLOAD_FILE scope.

Email Verification Requirement

A verified email is required to upload files.

Parameters

Name	Type	Location	Required	Description
`file`	file	body	Yes	The file

Request Content-Type

To upload a file, you must use the multipart/form-data content type.

Example Requests

cURLJS Fetch

curl -X POST \
-H "Authorization: eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q" \
-F "file=@/path/to/file.png" \
"https://alekeagle.me/api/upload"

const formData = new FormData();
formData.append('file', file);

fetch('https://alekeagle.me/api/upload', {
  method: 'POST',
  headers: {
    Authorization:
      'eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiVGhlIGV4YW1wbGUgdG9rZW4gZm9yIGRvY3MuYWxla2VhZ2xlLm1lIiwic3ViIjoiMTY0NzAxNTAyODYyNiIsImlhdCI6MTY4NzA2NzYxNCwiZXhwIjoyMDAyNjQzNjE0fQ.qAwhjhtGT56iAI52EsdVYcaTjmLPeR51TALkJ1CwRlfyDHwrsOTzAe8Y3za_tJqkvSaohwQq4cD7lZbTzMSw8Q',
  },
  body: formData,
});

Responses

201 Created
- SuccessfulUpload
400 Bad Request
- MissingFields
401 Unauthorized
- InvalidSession
403 Forbidden
413 Payload Too Large
- BodyTooLarge
429 Too Many Requests
- RateLimited
500 Internal Server Error
- Internal
503 Service Unavailable
- ServiceUnavailable

File Endpoints ​

GET /files ​

GET /users/:uid/files ​

GET /users/me/files ​

GET /files/:id ​

GET /users/:uid/files/:id ​

GET /users/me/files/:id ​

PUT /users/:uid/files/:id/name ​

PUT /users/me/files/:id/name ​

DELETE /users/:uid/files/:id/name ​

DELETE /users/me/files/:id/name ​

PUT /users/:uid/files/:id/extension ​

PUT /users/me/files/:id/extension ​

DELETE /users/:uid/files/:id ​

DELETE /users/me/files/:id ​

DELETE /users/:uid/files ​

DELETE /users/me/files ​

DELETE /files ​

DELETE /users/:uid/files/all ​

DELETE /users/me/files/all ​

POST /upload ​

File Endpoints

GET /files

GET /users/:uid/files

GET /users/me/files

GET /files/:id

GET /users/:uid/files/:id

GET /users/me/files/:id

PUT /users/:uid/files/:id/name

PUT /users/me/files/:id/name

DELETE /users/:uid/files/:id/name

DELETE /users/me/files/:id/name

PUT /users/:uid/files/:id/extension

PUT /users/me/files/:id/extension

DELETE /users/:uid/files/:id

DELETE /users/me/files/:id

DELETE /users/:uid/files

DELETE /users/me/files

DELETE /files

DELETE /users/:uid/files/all

DELETE /users/me/files/all

POST /upload