Problems
Every failure of the platform's services answers as a
problem, the standard form of an error over HTTP (RFC 9457). Its
type is /problems/ and its code
with dashes for its underscores, such as
/problems/unknown-series, and leads to the code's entry
here. A program branches on code; a person reads
detail, whose words may change.
Each entry says where the code is answered, with what status, whose
fault it is (class), and when. The same code may be answered
in several places, for the same kind of fault. The platform may add codes:
a client that meets one it does not know acts on the status. How to read a
problem, and what to do about the codes a reader meets most, is in the
guide.
128 codes:
absence_unstated ·
access_denied ·
ask_refused ·
batch_rejected ·
bus_unavailable ·
caller_left ·
client_refused ·
conflict ·
duplicate_series ·
duplicate_versions ·
egress_refused ·
events_unavailable ·
feeder_exists ·
feeder_failed ·
feeder_not_registered ·
feeder_retired ·
feeder_stopped ·
feeder_suspended ·
identity_unavailable ·
ingest_failed ·
ingest_unreachable ·
insufficient_scope ·
internal ·
invalid_answer ·
invalid_auth_method ·
invalid_batch_id ·
invalid_calendar ·
invalid_chart ·
invalid_credentials ·
invalid_cursor ·
invalid_declaration ·
invalid_duration ·
invalid_env ·
invalid_feeder_id ·
invalid_filter ·
invalid_flag ·
invalid_grant ·
invalid_host ·
invalid_input ·
invalid_key ·
invalid_known_by ·
invalid_migration_name ·
invalid_name ·
invalid_parameter ·
invalid_period ·
invalid_program ·
invalid_request ·
invalid_series ·
invalid_series_info ·
invalid_series_name ·
invalid_status ·
invalid_status_change ·
invalid_time ·
invalid_upload ·
invalid_username ·
invalid_value ·
known_in_future ·
lease_lost ·
lease_not_allowed ·
login_expired ·
login_refused ·
method_not_allowed ·
migration_changed ·
migration_failed ·
migration_missing ·
missing_column ·
model_failed ·
model_timeout ·
name_taken ·
namespace_reserved ·
namespace_taken ·
not_found ·
not_ready ·
not_recorded ·
outside_calendar ·
payload_too_large ·
program_exists ·
program_refused ·
programs_unavailable ·
provider_failed ·
publication_rule_failed ·
published_after_known ·
push_timeout ·
rate_limited ·
read_only_store ·
registry_failed ·
registry_unreachable ·
remote_store ·
remote_timeout ·
remote_unreachable ·
rule_broken ·
runner_busy ·
runner_short ·
runner_unavailable ·
secrets_unavailable ·
series_not_allowed ·
series_redefined ·
source_failed ·
source_refused ·
store_failed ·
store_unavailable ·
stuck ·
timeline_not_allowed ·
too_many_charts ·
too_many_functions ·
too_many_grants ·
too_many_programs ·
too_many_requests ·
too_many_variables ·
too_many_versions ·
unauthenticated ·
unit_mismatch ·
unknown_calendar ·
unknown_client ·
unknown_column ·
unknown_feeder ·
unknown_function ·
unknown_indicator ·
unknown_kind ·
unknown_program ·
unknown_receipt ·
unknown_runtime ·
unknown_series ·
unknown_version ·
unsupported_media_type ·
upload_needed ·
version_suspended ·
wrong_columns
absence_unstated · Absence unstated
| Where | Status | Class | When |
| The data | 422 | DataContractError | A missing value that does not say why: its status must be no_data, cancelled, withdrawn or partial |
access_denied · Access denied
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | The caller has no namespace (neither a feeder, the publisher, nor a person with a one-segment user name); a heartbeat from anyone but a registered feeder |
| The read API's people's functions | 403 | AccessDenied | Another person's path, or a client: people manage their own functions alone |
| The read API's programs | 403 | AccessDenied | A client, or a program itself, asking to keep programs or charts: those are a person's, signed in. From the registry: an owner without the right to read |
| People's functions, to the caller | 403 | AccessDenied | A person's function is called by a person, not by a service's own token. |
ask_refused · Ask refused
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 502 | SourceError | Its source will not answer for one series, such as an unknown symbol: that series only |
batch_rejected · Batch rejected
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 422 | DataContractError | The ingestor answered a batch with a receipt whose outcome is rejected (200) and that held no series' problem to pass on, as a receipt kept from before 3.2.18 may: the feeder treats it as the refusal it was |
bus_unavailable · Bus unavailable
| Where | Status | Class | When |
The clients and the tools: KafkaBus, bff-bus | 502 | SourceError | Kafka cannot be reached, or did not take the event |
caller_left · Caller left
| Where | Status | Class | When |
| People's functions, to the nobody | 500 | Service | The caller closed the connection before the answer: recorded with the run, seen by no one. |
client_refused · Client refused
| Where | Status | Class | When |
The clients and the tools: ClientCredentials (Rust) | 403 | AccessDenied | The identity provider refused the client: wrong credentials, or disabled |
conflict · Conflict
| Where | Status | Class | When |
| The read API's people's functions | 409 | InvalidRequest | Removing a variable a released version declares |
| People's functions, to the author | 409 | InvalidRequest | A variable a released version declares cannot be deleted: change its value, but it stays. |
duplicate_series · Duplicate series
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | One series twice in a push |
duplicate_versions · Duplicate versions
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row that contradicts a stored one, or another in the push: a value, its status and its flags make a version (3.2.14) |
egress_refused · Egress refused
| Where | Status | Class | When |
| The read API's people's functions | none | AccessDenied | The runner's proxy refused a function's connection: a host it did not declare or no operator approved, a port other than 443, an address that is not the internet's, a server name that is not the host's. The function sees a failed connection (status is what the proxy answered it); the run's record counts it |
events_unavailable · Events unavailable
| Where | Status | Class | When |
| The read API's stream of changes | 503 | SourceError | The read API follows no bus: read again to see what is new |
The clients and the tools: Platform | 400 | InvalidRequest | events or listen, or now or serve on a timeline other than live, without a bus |
feeder_exists · Feeder exists
| Where | Status | Class | When |
| The feeder registry | 409 | InvalidRequest | A record, or a client in the identity provider, has that id |
feeder_failed · Feeder failed
| Where | Status | Class | When |
| The clients and the tools: The ingestor | 502 | SourceError | A heartbeat that failed, whose feeder sent no error of its own |
feeder_not_registered · Feeder not registered
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | A feeder.… client without a record in the registry |
The clients and the tools: bff-feeder | 403 | AccessDenied | From the ingestor's GET /me, as above |
feeder_retired · Feeder retired
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | The feeder's status is retired. From the registry: InvalidRequest, 400, on changing a retired feeder, adding it a namespace or renewing its secret |
The clients and the tools: bff-feeder | 403 | AccessDenied | From the ingestor's GET /me, as above |
feeder_stopped · Feeder stopped
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 502 | SourceError | The feeder was stopped before the run ended |
feeder_suspended · Feeder suspended
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | The feeder's status is suspended |
The clients and the tools: bff-feeder | 403 | AccessDenied | From the ingestor's GET /me, as above |
identity_unavailable · Identity unavailable
| Where | Status | Class | When |
The clients and the tools: ClientCredentials (Python) | 502 | SourceError | The identity provider, or its discovery document, cannot be reached |
ingest_failed · Ingest failed
| Where | Status | Class | When |
The clients and the tools: IngestClient (Python), bff-feeder | 502 | SourceError | The ingestor answered without a structured error |
ingest_unreachable · Ingest unreachable
| Where | Status | Class | When |
The clients and the tools: IngestClient (Python), bff-feeder | 502 | SourceError | The ingestor cannot be reached. Python's client treats it as a 503, and retries |
insufficient_scope · Insufficient scope
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | The token lacks the endpoint's scope |
internal · Internal
| Where | Status | Class | When |
| What failed on the platform's side | 500 | InternalError | A bug |
invalid_answer · Invalid answer
| Where | Status | Class | When |
| The read API's people's functions | 500 | ModelError | The answer broke the function's declaration; run as above |
| People's functions, to the caller | 500 | Model | The answer broke its declaration: an output missing, a value outside the period, over 200,000 values or 16 MiB. |
invalid_auth_method · Invalid auth method
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | Neither private_key_jwt nor client_secret_basic |
invalid_batch_id · Invalid batch id
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A batch_id that is not 1 to 100 characters of A-Z a-z 0-9 _ . : - |
invalid_calendar · Invalid calendar
| Where | Status | Class | When |
| The calendars | 422 | DataContractError | A row of ref.calendar, ref.publication_calendars or ref.holidays that does not fit the model (details.table, details.id) |
invalid_chart · Invalid chart
| Where | Status | Class | When |
| The read API's charts | 400 | InvalidRequest | An id that is not 1 to 40 lowercase letters, digits and dashes; a name not 1 to 80 characters; a position not 0 to 999; a spec that is not an object (field names which) |
invalid_credentials · Invalid credentials
| Where | Status | Class | When |
The clients and the tools: ClientCredentials (Python) | 400 | InvalidRequest | The identity provider refused the client's credentials |
invalid_cursor · Invalid cursor
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A list read by pages was given a cursor that is not its own for the request (platform.md). reason says which: malformed, no cursor a list gave, or one cut short or changed; outdated, one of another version of the encoding, from before a release; other_list, another list's; other_request, this list's asked with other parameters. field is cursor. Read the list again from its first page. A limit that is no whole number from 1 is invalid_request, with field: limit; one above the maximum is lowered, not refused |
invalid_declaration · Invalid declaration
| Where | Status | Class | When |
| The read API's people's functions | none | InvalidRequest | What a function declares breaks a rule. Never an HTTP answer: the version fails its checks, and its report holds the message and the field |
invalid_duration · Invalid duration
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | An expected_every that is not an ISO 8601 duration such as PT1H |
invalid_env · Invalid env
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | A variable's name not [A-Z][A-Z0-9_]*, or one the platform sets |
| People's functions, to the author | 400 | InvalidRequest | A variable's name is A-Z, 0-9 and _, starting with a letter, at most 64 characters, and not one the platform sets. |
invalid_feeder_id · Invalid feeder id
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | An id that is not feeder. and segments, or is over 100 characters |
invalid_filter · Invalid filter
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A list's filter that does not read: a field the list does not filter by (filter_field), an operator its kind does not take, a value not of its kind, a parenthesis or a quote left open. position is where in the filter, from 0; field is filter (platform.md) |
invalid_flag · Invalid flag
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row whose status does not fit it (a value's is preliminary, provisional or final; an absence's its reason), an unknown flag or way of being known, a publication after the known time, or a period that ends before it starts |
invalid_grant · Invalid grant
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Not user:{username}, role:trader, role:analyst or everyone |
| People's functions, to the author | 400 | InvalidRequest | A grant is user:{username}, role:trader, role:analyst or everyone. |
invalid_host · Invalid host
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Not an exact, lowercase host name |
invalid_key · Invalid key
| Where | Status | Class | When |
| The read API's programs | 400 | InvalidRequest | Not the public half of an RSA key of 2,048 to 8,192 bits, for signing with RS256, with an id (kid). A key with a private field is refused in so many words: it has travelled, and a new one is made |
The clients and the tools: ClientCredentials (Rust) | 400 | InvalidRequest | A client that signs in with its key (private_key_jwt) was given one that is not RSA in PEM |
invalid_known_by · Invalid known by
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row whose status does not fit it (a value's is preliminary, provisional or final; an absence's its reason), an unknown flag or way of being known, a publication after the known time, or a period that ends before it starts |
invalid_migration_name · Invalid migration name
| Where | Status | Class | When |
The clients and the tools: bff migrate | 400 | InvalidRequest | A migration the database ran is not in the folder, one was changed after it ran, or a file's name is not a migration's |
invalid_name · Invalid name
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | A function's name that is not one segment of at most 64 characters |
| People's functions, to the author | 400 | InvalidRequest | A function's name is a-z, 0-9 and _, starting with a letter, at most 64 characters. |
invalid_parameter · Invalid parameter
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A timeline that is not one; a registration's or change's field that is missing or does not fit (no namespace, a namespace twice, a blank owner, a jwks_url for a feeder that signs with a secret); a status change without a reason; a secret for a feeder that signs with its key |
| People's functions, to the caller | 400 | InvalidRequest | A parameter is outside its declared range, or not of its type; the problem's detail names it. |
invalid_period · Invalid period
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row whose status does not fit it (a value's is preliminary, provisional or final; an absence's its reason), an unknown flag or way of being known, a publication after the known time, or a period that ends before it starts |
invalid_program · Invalid program
| Where | Status | Class | When |
| The read API's programs | 400 | InvalidRequest | A program's name that is not a-z, 0-9 and _, starting with a letter, at most 32 characters (field says whether the name or the owner's) |
invalid_request · Invalid request
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A body that is not JSON or does not fit the endpoint; a push without series; a read without names; a heartbeat without ok |
| People's functions, to the author, caller | 400 | InvalidRequest | The request broke a rule it names: a field missing, one it does not know, or a period that ends before it starts. |
invalid_series · Invalid series
| Where | Status | Class | When |
| The data | 422 | DataContractError | A series that breaks the wire format: not an object, a description without a name, missing or unequal columns, a value or a time that does not fit |
invalid_series_info · Invalid series info
| Where | Status | Class | When |
| The data | 422 | DataContractError | A series that breaks the wire format: not an object, a description without a name, missing or unequal columns, a value or a time that does not fit |
invalid_series_name · Invalid series name
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A name that breaks the grammar, or is over 200 characters |
invalid_status · Invalid status
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | A status other than active, suspended or retired |
| The data | 422 | DataContractError | A row whose status does not fit it (a value's is preliminary, provisional or final; an absence's its reason), an unknown flag or way of being known, a publication after the known time, or a period that ends before it starts |
invalid_status_change · Invalid status change
| Where | Status | Class | When |
| The feeder registry | 409 | InvalidRequest | A move the status diagram does not allow |
| The read API's people's functions | 409 | InvalidRequest | A move a version's state does not allow: releasing what is not ready, deleting what is released (deprecate it first) or being checked |
| People's functions, to the author | 409 | InvalidRequest | The version cannot go from its state to that one: a draft being checked cannot be released or deleted; a released one is deprecated before it can be deleted. |
invalid_time · Invalid time
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A read's start, end or recorded_after (until 3.2.18 also known_before) that is not a time with its offset |
| The data | 422 | DataContractError | A series that breaks the wire format: not an object, a description without a name, missing or unequal columns, a value or a time that does not fit |
| People's functions, to the caller | 400 | InvalidRequest | start, end or as_of is not a time with its zone. |
invalid_upload · Invalid upload
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Not a Python file or a zip; a path that reaches out, a link, two paths differing by case, more than 1,000 files; no main.py and not one .py at the top |
| People's functions, to the author | 400 | InvalidRequest | The upload broke a rule it names: a .py or a .zip, main.py or one .py at the top, at most 1,000 files, 50 MiB, 200 MiB unpacked. |
invalid_username · Invalid username
| Where | Status | Class | When |
| The read API's people's functions | 403 | AccessDenied | A user name that cannot own functions: not one segment of at most 32 characters |
| The read API's programs | 403 | AccessDenied | A user name that cannot own a program |
| People's functions, to the author | 403 | AccessDenied | Your user name cannot own functions: it must be a-z, 0-9 and _, starting with a letter, at most 32 characters. Ask an operator. |
invalid_value · Invalid value
| Where | Status | Class | When |
| The data | 422 | DataContractError | A series that breaks the wire format: not an object, a description without a name, missing or unequal columns, a value or a time that does not fit |
known_in_future · Known in future
| Where | Status | Class | When |
| The data | 422 | DataContractError | A known time later than the database's clock plus the allowed skew |
lease_lost · Lease lost
| Where | Status | Class | When |
| One copy of a feeder at a time | 409 | InvalidRequest | A push or a heartbeat from a copy of a feeder (Lease-Holder) that no longer holds the feeder's lease: another copy took it, or it ended. Nothing of it is stored, and no receipt is kept: the copy that holds the lease reads and pushes. feeder and holder say whose. A feeder's own copy says the same when it stops a run whose lease it could not keep, before the ingestor would let another take it |
lease_not_allowed · Lease not allowed
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | A lease asked for (PUT /v1/leases/{feeder}) by a caller that is not that feeder: another feeder's, or a person's or the publisher's. feeder names the lease |
login_expired · Login expired
| Where | Status | Class | When |
The clients and the tools: bff login | 403 | AccessDenied | The identity provider refused the sign-in, or it lapsed before it was approved |
login_refused · Login refused
| Where | Status | Class | When |
The clients and the tools: bff login | 403 | AccessDenied | The identity provider refused the sign-in, or it lapsed before it was approved |
method_not_allowed · Method not allowed
| Where | Status | Class | When |
| The request | 405 | InvalidRequest | A method the path does not take; Allow lists those it does |
migration_changed · Migration changed
| Where | Status | Class | When |
The clients and the tools: bff migrate | 400 | InvalidRequest | A migration the database ran is not in the folder, one was changed after it ran, or a file's name is not a migration's |
migration_failed · Migration failed
| Where | Status | Class | When |
The clients and the tools: bff migrate | 502 | SourceError | The database refused a migration |
migration_missing · Migration missing
| Where | Status | Class | When |
The clients and the tools: bff migrate | 400 | InvalidRequest | A migration the database ran is not in the folder, one was changed after it ran, or a file's name is not a migration's |
missing_column · Missing column
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 422 | DataContractError | A configured column is not in the file |
model_failed · Model failed
| Where | Status | Class | When |
| The read API's people's functions | 500 | ModelError | The code raised, ended or ran out of memory; run is the run's id, and its owner reads why in its log |
| People's functions, to the caller | 500 | Model | The code raised an error, ended, ran out of memory, or wrote outside its scratch folder. The caller reads the error's first line; the log, with the traceback, is the owner's for their own calls and the checks, and an operator's for any. |
model_timeout · Model timeout
| Where | Status | Class | When |
| The read API's people's functions | 504 | ServiceError | Over its time; the worker loads again |
| People's functions, to the caller | 504 | Service | The call took more than its declared time: do less in a call, or declare more, up to 60 s for a model and 5 s for an indicator. |
name_taken · Name taken
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | The name is the owner's other kind's, or another person's |
| People's functions, to the author | 400 | InvalidRequest | You have a function of that name already: a name is yours once, across models and indicators. |
namespace_reserved · Namespace reserved
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | A namespace that is reserved, is not one segment, or is over 32 characters |
namespace_taken · Namespace taken
| Where | Status | Class | When |
| The feeder registry | 409 | InvalidRequest | Another feeder has, or had, the namespace |
not_found · Not found
| Where | Status | Class | When |
| The request | 404 | InvalidRequest | A path no service serves. (Each service's own not_found is below, with what was not found) |
| The read API's charts | 404 | InvalidRequest | No chart of the caller's with that id |
| The read API's people's functions | 404 | InvalidRequest | No function, version, variable or run of the caller's |
| People's functions, to the author | 404 | InvalidRequest | No such function, version, variable, host or request of yours. |
not_ready · Not ready
| Where | Status | Class | When |
| What failed on the platform's side | 503 | ServiceError | A feeder's or the relay's own /ready: the feeder's last run failed, was long ago or has not ended; the relay's rounds have failed for a minute. details holds the report |
not_recorded · Not recorded
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Inside a retest only: the function asks for a read its version's check did not make, and a retest reads what was recorded alone (key names the read) |
outside_calendar · Outside calendar
| Where | Status | Class | When |
| The calendars | 400 | InvalidRequest | A day no rule of that calendar holds |
payload_too_large · Payload too large
| Where | Status | Class | When |
| The request | 413 | InvalidRequest | A push or a read over a limit of size: a body, its series or rows; a read API read's rows (the ingestor's GET /v1/values is paged since 3.2.18). (The read API refuses a read of more than 20 series with invalid_request, 400: a count of names is the request's form, not its size) |
| The read API's people's functions | 413 | InvalidRequest | An upload over 50 MiB, or 200 MiB unpacked; a variable over 4 KiB |
| People's functions, to the author, caller | 413 | InvalidRequest | An upload over 50 MiB; a variable over 4 KiB; inside a call, a read past the run's budget of 20 reads and 400,000 values: read fewer series or a shorter period. |
program_exists · Program exists
| Where | Status | Class | When |
| The read API's programs | 409 | InvalidRequest | The person has a program of that name |
program_refused · Program refused
| Where | Status | Class | When |
| The read API's programs | 403 | AccessDenied | A program's own call, on any route: it is suspended (the reason is told), has no record, or its owner may no longer read. Whatever its token says |
programs_unavailable · Programs unavailable
| Where | Status | Class | When |
| The read API's programs | 503 | ServiceError | The registry that keeps programs does not answer the read API, or the read API is told of none |
provider_failed · Provider failed
| Where | Status | Class | When |
| What failed on the platform's side | 503 | SourceError | The identity provider did not answer: the registry's admin calls, or keys the verifier lacks |
publication_rule_failed · Publication rule failed
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 422 | DataContractError | A known-time rule has no answer for a time |
published_after_known · Published after known
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row whose status does not fit it (a value's is preliminary, provisional or final; an absence's its reason), an unknown flag or way of being known, a publication after the known time, or a period that ends before it starts |
push_timeout · Push timeout
| Where | Status | Class | When |
| What failed on the platform's side | 503 | SourceError | A push was not stored within the limit on its transaction, and the database stopped it. Nothing of it is stored and it leaves no receipt: send the same batch again, and fewer rows in a batch if it is stopped again |
rate_limited · Rate limited
| Where | Status | Class | When |
| Who the caller is, and what it may do | 429 | InvalidRequest | More calls a minute from one identity than the ingestor takes |
| The read API's people's functions | 429 | InvalidRequest | More calls a minute of the caller's, across people's functions and every copy of the read API, than an operator has set; none is set unless one is (3.2.12) |
| The read API's stream of changes | 429 | InvalidRequest | The caller holds 8 streams open, or the read API all it may, across its copies. limit is the limit met, and of whose: person or all |
The clients and the tools: bff-feeder | 429 | InvalidRequest | Its source limits calls, and the limit is reached |
| People's functions, to the caller | 429 | InvalidRequest | Over the calls a minute an operator has set, across people's functions; none is set unless one is. Try again after Retry-After. |
read_only_store · Read only store
| Where | Status | Class | When |
| The clients and the tools: The observation service's store, its client | 400 | InvalidRequest | A write: data enters through the ingestor |
registry_failed · Registry failed
| Where | Status | Class | When |
The clients and the tools: bff | 502 | SourceError | The feeder registry cannot be reached, or answered without a structured error |
registry_unreachable · Registry unreachable
| Where | Status | Class | When |
The clients and the tools: bff | 502 | SourceError | The feeder registry cannot be reached, or answered without a structured error |
remote_store · Remote store
| Where | Status | Class | When |
The clients and the tools: Ingestor | 400 | InvalidRequest | The platform's store, given to the in-process Ingestor: run the source with Platform.feed |
remote_timeout · Remote timeout
| Where | Status | Class | When |
| What failed on the platform's side | 502, 504 | RemoteError | What stands in front of the read API's copies, for them: the read API's address on the host (api-front) and on the pilot's server (Caddy). No copy could be reached, or the copy that took the request stopped before it answered (a call under way), or did not answer in time. Without instance |
remote_unreachable · Remote unreachable
| Where | Status | Class | When |
| What failed on the platform's side | 502, 504 | RemoteError | What stands in front of the read API's copies, for them: the read API's address on the host (api-front) and on the pilot's server (Caddy). No copy could be reached, or the copy that took the request stopped before it answered (a call under way), or did not answer in time. Without instance |
rule_broken · Rule broken
| Where | Status | Class | When |
| The data | 422 | DataContractError | A row the store refuses by one of its own rules, named in details.rule |
runner_busy · Runner busy
| Where | Status | Class | When |
| The read API's people's functions | 503 | ServiceError | No worker free within 10 s; Retry-After |
| People's functions, to the caller | 503 | Service | Every worker is busy; try again after Retry-After. |
runner_short · Runner short
| Where | Status | Class | When |
| The read API's people's functions | 503 | ServiceError | The runner's own /ready: a pool has had fewer workers than it is meant to for longer than a restart takes. It still serves; Docker and Operations read this |
runner_unavailable · Runner unavailable
| Where | Status | Class | When |
| The read API's people's functions | 503 | ServiceError | The runner does not answer, or the read API has none |
| People's functions, to the caller | 503 | Service | No worker has joined, or the runner did not answer in 90 s (a load that takes longer than that): try again; if it lasts, tell an operator. |
secrets_unavailable · Secrets unavailable
| Where | Status | Class | When |
| The read API's people's functions | 503 | SourceError | The read API has no key for variables |
| People's functions, to the author | 503 | Source | The platform cannot read its variables' key: tell an operator. |
series_not_allowed · Series not allowed
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | A read of a series under another feeder's namespace, or a reserved one; the same whether the series exists or not |
series_redefined · Series redefined
| Where | Status | Class | When |
| The data | 422 | DataContractError | A description other than the stored one |
source_failed · Source failed
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 502 | SourceError | Its source could not be read |
source_refused · Source refused
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 502 | SourceError | Its source refused the feeder's token or key |
store_failed · Store failed
| Where | Status | Class | When |
| What failed on the platform's side | 502 | SourceError | The database refused a statement |
store_unavailable · Store unavailable
| Where | Status | Class | When |
| What failed on the platform's side | 503 | SourceError | The database cannot be reached |
stuck · Stuck
| Where | Status | Class | When |
| What failed on the platform's side | 503 | ServiceError | A feeder's or the relay's own /health: its loop has not moved (for one minute, a feeder's; for two, the relay's). Docker reads this, and restarts it |
timeline_not_allowed · Timeline not allowed
| Where | Status | Class | When |
| Who the caller is, and what it may do | 403 | AccessDenied | A timeline the caller may not push on |
too_many_charts · Too many charts
| Where | Status | Class | When |
| The read API's charts | 400 | InvalidRequest | A new chart beyond the 32 a person may keep |
too_many_functions · Too many functions
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Over the limits: 20 functions a person, 50 versions a function, 100 grants, 20 variables, 20 open library requests |
| People's functions, to the author | 400 | InvalidRequest | Over 20 functions: delete one you no longer need. |
too_many_grants · Too many grants
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Over the limits: 20 functions a person, 50 versions a function, 100 grants, 20 variables, 20 open library requests |
| People's functions, to the author | 400 | InvalidRequest | Over 100 grants on one function. |
too_many_programs · Too many programs
| Where | Status | Class | When |
| The read API's programs | 400 | InvalidRequest | Over the 10 a person may keep |
too_many_requests · Too many requests
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Over the limits: 20 functions a person, 50 versions a function, 100 grants, 20 variables, 20 open library requests |
| People's functions, to the author | 400 | InvalidRequest | Over 20 library requests open: wait for an answer. |
too_many_variables · Too many variables
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Over the limits: 20 functions a person, 50 versions a function, 100 grants, 20 variables, 20 open library requests |
| People's functions, to the author | 400 | InvalidRequest | Over 20 variables on one function. |
too_many_versions · Too many versions
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | Over the limits: 20 functions a person, 50 versions a function, 100 grants, 20 variables, 20 open library requests |
| People's functions, to the author | 400 | InvalidRequest | Over 50 versions of one function: delete drafts, or the function, and start again. |
unauthenticated · Unauthenticated
| Where | Status | Class | When |
| Who the caller is, and what it may do | 401 | AccessDenied | No bearer token, or one that fails a check (signature, issuer, audience, times). The reason is logged, not told |
The clients and the tools: Platform.ingestor, feed, push | 401 | InvalidRequest | No person's access token |
unit_mismatch · Unit mismatch
| Where | Status | Class | When |
The clients and the tools: bff-feeder | 502 | SourceError | Its source answers one series in another unit or currency than the series' (3.2.17), such as ENTSO-E in kilowatts for a series in MW: that series only, and nothing of the answer is stored |
unknown_calendar · Unknown calendar
| Where | Status | Class | When |
| The calendars | 400 | InvalidRequest | No delivery calendar for that zone, market and product, or no publication calendar of that name |
unknown_client · Unknown client
| Where | Status | Class | When |
| The feeder registry | 400 | InvalidRequest | The identity provider has no client of that id |
unknown_column · Unknown column
| Where | Status | Class | When |
| The data | 422 | DataContractError | A series that carries a column the contract does not name; from 3.2.14 it is refused, not ignored |
unknown_feeder · Unknown feeder
| Where | Status | Class | When |
| The feeder registry | 404 | InvalidRequest | No record with that id |
unknown_function · Unknown function
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | No such function, or one the caller may not call: the same answer. Before 3.2.18 the path named the kind, and the code said it: unknown_model, unknown_indicator |
| People's functions, to the caller | 400 | InvalidRequest | No such function, or one you may not call: the same answer. An owner calling their own draft names its version in the path. |
unknown_indicator · Unknown indicator
| Where | Status | Class | When |
| The read API's indicators | 400 | InvalidRequest | No indicator of that id; known in the details |
unknown_kind · Unknown kind
| Where | Status | Class | When |
| The data | 422 | DataContractError | A kind other than number, text and array |
unknown_program · Unknown program
| Where | Status | Class | When |
| The read API's programs | 404 | InvalidRequest | No program of that name of the person's; for an operator, no program of that id |
unknown_receipt · Unknown receipt
| Where | Status | Class | When |
| The request | 404 | InvalidRequest | No receipt of the caller's with that batch id |
unknown_runtime · Unknown runtime
| Where | Status | Class | When |
| The read API's people's functions | 400 | InvalidRequest | No runtime of that name in use, or none yet |
| People's functions, to the author | 400 | InvalidRequest | No runtime of that name; leave it out for the newest. |
unknown_series · Unknown series
| Where | Status | Class | When |
| The request | 400 | InvalidRequest | A read of the read API names a series that is not there, or one the caller may not read: the same answer. unknown lists them |
| People's functions, to the caller | 400 | InvalidRequest | A series the call names does not exist, or you may not read it: a function reads with its caller's rights. |
unknown_version · Unknown version
| Where | Status | Class | When |
| The read API's indicators | 400 | InvalidRequest | No such version of it; versions in the details |
| The read API's people's functions | 400 | InvalidRequest | No such version, or a draft and the caller is not its owner; versions lists the released |
| People's functions, to the caller | 400 | InvalidRequest | No such version. For a version that exists and does not answer, the details list the released ones. |
upload_needed · Upload needed
| Where | Status | Class | When |
| The read API's people's functions | 409 | InvalidRequest | The runner's own answer to the read API, never a caller's: it does not hold the version's upload. The read API sends it and asks again |
version_suspended · Version suspended
| Where | Status | Class | When |
| The read API's people's functions | 403 | AccessDenied | An operator stopped it; reason says why |
| People's functions, to the caller | 403 | AccessDenied | An operator stopped the version; the reason says why. |
wrong_columns · Wrong columns
| Where | Status | Class | When |
| The data | 422 | DataContractError | A series that breaks the wire format: not an object, a description without a name, missing or unequal columns, a value or a time that does not fit |