Create a file
POST
/api/tenant/{tenantId}/Files
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.nimles.com/media/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Files"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"fields\": { \"additionalProperty\": { \"value\": \"example\", \"valueType\": \"example\" } }, \"accessibility\": \"example\", \"relations\": [ { \"fields\": { \"additionalProperty\": { \"value\": \"example\", \"valueType\": \"example\" } }, \"accessibility\": \"example\", \"id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"name\": \"example\", \"entityId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"entityType\": \"example\", \"relationType\": \"example\" } ], \"resourceGroupId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"creatorId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"createdDate\": \"2026-04-15T12:00:00Z\", \"version\": 1, \"lastModified\": \"2026-04-15T12:00:00Z\", \"folderId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"fileDate\": \"2026-04-15T12:00:00Z\", \"uri\": \"example\", \"thumbnailUri\": \"example\", \"originalUri\": \"example\", \"fileName\": \"example\", \"size\": 1, \"mimeType\": \"example\", \"name\": \"example\", \"description\": \"example\", \"provider\": \"example\", \"providerExternalId\": \"example\", \"author\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://api.nimles.com/media/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Files';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"fields":{"additionalProperty":{"value":"example","valueType":"example"}},"accessibility":"example","relations":[{"fields":{"additionalProperty":{"value":"example","valueType":"example"}},"accessibility":"example","id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","name":"example","entityId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","entityType":"example","relationType":"example"}],"resourceGroupId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","creatorId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","createdDate":"2026-04-15T12:00:00Z","version":1,"lastModified":"2026-04-15T12:00:00Z","folderId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","fileDate":"2026-04-15T12:00:00Z","uri":"example","thumbnailUri":"example","originalUri":"example","fileName":"example","size":1,"mimeType":"example","name":"example","description":"example","provider":"example","providerExternalId":"example","author":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.nimles.com/media/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Files \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "relations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entityType": "example", "relationType": "example" } ], "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "createdDate": "2026-04-15T12:00:00Z", "version": 1, "lastModified": "2026-04-15T12:00:00Z", "folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fileDate": "2026-04-15T12:00:00Z", "uri": "example", "thumbnailUri": "example", "originalUri": "example", "fileName": "example", "size": 1, "mimeType": "example", "name": "example", "description": "example", "provider": "example", "providerExternalId": "example", "author": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”tenantId
required
string format: uuid
Your tenant id.
Request Body
Section titled “Request Body”Media typeapplication/json
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
relations
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
name
string
entityId
required
string format: uuid
entityType
required
string
relationType
required
string
resourceGroupId
string format: uuid
creatorId
string format: uuid
createdDate
string format: date-time
version
integer format: int32
lastModified
string format: date-time
folderId
string format: uuid
fileDate
string format: date-time
uri
required
string
thumbnailUri
string
originalUri
string
fileName
string
size
integer format: int64
mimeType
string
name
required
string
description
string
provider
string
providerExternalId
string
author
string
Example generated
{ "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "relations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entityType": "example", "relationType": "example" } ], "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "createdDate": "2026-04-15T12:00:00Z", "version": 1, "lastModified": "2026-04-15T12:00:00Z", "folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fileDate": "2026-04-15T12:00:00Z", "uri": "example", "thumbnailUri": "example", "originalUri": "example", "fileName": "example", "size": 1, "mimeType": "example", "name": "example", "description": "example", "provider": "example", "providerExternalId": "example", "author": "example"}Responses
Section titled “Responses”Created. The body is the item, or { data: { id } } when it cannot be read yet. Location is the item’s path within the service, /api/tenant/{tenantId}/{Resource}/{id}, without the /{service} prefix api.nimles.com routes by: use data.id from the body.
Media typeapplication/json
One of:
object
fields
object
key
additional properties
string
data
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
relations
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
name
string
entityId
required
string format: uuid
entityType
required
string
relationType
required
string
tenantId
string format: uuid
resourceGroupId
string format: uuid
creatorId
string format: uuid
createdDate
string format: date-time
version
integer format: int32
lastModified
string format: date-time
folderId
string format: uuid
ocr
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
language
required
string
textAngle
required
number format: double
orientation
required
string
regions
required
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
lines
required
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
words
required
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
text
required
string
fileDate
string format: date-time
uri
string
thumbnailUri
string
originalUri
string
fileName
string
size
integer format: int64
mimeType
string
name
string
description
string
provider
string
providerExternalId
string
author
string
object
data
The id of a new item, when the create answers before the item can be read.
object
id
string format: uuid
fields
object
key
additional properties
string
Example generated
{ "data": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "relations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entityType": "example", "relationType": "example" } ], "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "createdDate": "2026-04-15T12:00:00Z", "version": 1, "lastModified": "2026-04-15T12:00:00Z", "folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ocr": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "language": "example", "textAngle": 1, "orientation": "example", "regions": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "lines": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "words": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "text": "example" } ] } ] } ] }, "fileDate": "2026-04-15T12:00:00Z", "uri": "example", "thumbnailUri": "example", "originalUri": "example", "fileName": "example", "size": 1, "mimeType": "example", "name": "example", "description": "example", "provider": "example", "providerExternalId": "example", "author": "example" }}Headers
Section titled “Headers”Location
string
The new item’s path within the service, without the service prefix: /api/tenant/{tenantId}/{Resource}/{id}.
Unauthorized: no bearer token, or one that is expired or not for this API.
Forbidden: the caller holds no role that allows this action at this scope. The body is empty, or a problem whose detail names the action.
Media typeapplication/json
An RFC 9457 problem.
object
detail
string
instance
string
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Conflict: the item kept changing under concurrent writes; read it again and retry.
Media typeapplication/problem+json
An RFC 9457 problem.
object
detail
string
instance
string
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Unprocessable: the body or the change is invalid. The errors are keyed by member.
Media typeapplication/problem+json
A validation problem: the messages by member (or by JSON Pointer for a patch).
object
errors
object
key
additional properties
Array<string>
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "errors": { "additionalProperty": [ "example" ] }, "status": 1, "title": "example", "type": "example"}