Retrieve files

Retrieves metadata information about multiple specific files in the same project. Results are returned in the same order as in the request. This operation does not return the file contents.

Request throttling

This endpoint is a subject of the new throttling schema (limited request rate and concurrency). Please check Files resource description for more information.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
Request Body schema: application/json
required

List of IDs of files to retrieve. Must be up to a maximum of 1000 IDs, and all of them must be unique.

required
Array of Select by Id (object) or Select by ExternalId (object) (FileSelectEither) [ 1 .. 1000 ] items
ignoreUnknownIds
boolean
Default: false

Ignore IDs and external IDs that are not found

Responses
200

The response for a successful files/byids, files/search or files/update operation

400

The response for a failed request.

post/files/byids
Request samples
application/json
{
  • "items": [
    • {
      }
    ],
  • "ignoreUnknownIds": false
}
Response samples
application/json
{
  • "items": [
    • {
      }
    ]
}