Akter

Logs

An app's log: what its deploys did, oldest first. By default lines are kept 7 days, and at most the newest 10000 per app.

Read⁠

GEThttps://api.akter.dev/v1/organizations/{organization}/apps/{app}/logs
logs.readBearer token

Read an app's log lines oldest first, a page at a time, optionally only one source, one deploy or the lines since a time. Every page carries nextCursor, the last line read: pass it to read on, now or later, and an empty page means nothing newer yet.

Path parameters

  • appstringrequired

    An app's name, unique within its organization. 1 to 63 characters: a lowercase letter, then lowercase letters, digits or single hyphens, ending in a letter or digit.

  • organizationstringrequired

    An organization's name, unique across Akter Cloud. 1 to 63 characters: a lowercase letter, then lowercase letters, digits or single hyphens, ending in a letter or digit.

Query parameters

  • cursorstring

    The nextCursor of the previous page.

  • limitstring

    At most this many items, 1 to 100. Defaults to 50.

  • deploystring

    Only the lines about this deploy.

  • sincestring

    Only the lines written at or after this time.

  • source"deploy" | "computer"

    What wrote the line: deploy for a deploy's lifecycle, computer for what happened to one of an actor's computers.

Response 200LogPage

  • itemsLogLine[]required
  • items[].atstringrequired
  • items[].level"info" | "warning" | "error"required
  • items[].messagestringrequired
  • items[].source"deploy" | "computer"required

    What wrote the line: deploy for a deploy's lifecycle, computer for what happened to one of an actor's computers.

  • items[].subjectstringrequired

    What the line is about: a deploy's id for deploy lines, and <environment>/<Actor>/<key>/<computer> for computer lines.

  • nextCursorstring

    Pass as cursor for the next page.

Errors

  • 401UnauthorizedError
  • 403ForbiddenError
  • 404NotFoundError | FeatureNotEnabledError
  • 503ActorUnavailableError | AuthUnavailableError | BillingUnavailableError | BuildStorageUnavailableError | ExecUnavailableError