Skip to content

File.get

GET /{namespace}/files/{id}

Returns one File by id.

Noun
File
Mode
read

Get returns one File by id. It is inherited: every Noun has get, list, create, update and delete.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the File.
atstringA time or Version name: the record as it stood then. Unset: as it stands now.

Outputs

OutputTypeRequiredDescription
fileFilerequiredThe File.

Effects

  • Reads only: it emits no Event and changes nothing.
  • Read: try, do.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.File.get

When it waits

Never: a read runs at once.