Skip to main content
GET
cURL
At most 5 streams can be open at the same time per account, and at most 20 new connections can be opened per minute. Close the streams you no longer need.
This endpoint is read-only: it only sends the output of the application. There is no way to send input or commands to the application through it.

How the stream behaves

  1. When the stream opens you receive ready, then clear and the last tail lines (100 by default).
  2. After that, every new line arrives as a log event as soon as the application writes it.
  3. When the application stops or starts you receive status with die or start. After a start you receive clear and the first lines of the new run.
  4. The server closes every stream after 30 minutes with end and reason: "timeout", and also when it loses the connection to the server that runs the application (worker-lost) or when your client reads too slowly (slow-client). Reconnect when that happens; the permissions are checked again on every connection.
Always handle clear by discarding what you have shown. That is how you avoid showing the same lines twice after a reconnection.

Examples

The browser EventSource API cannot send the Authorization header, so call this endpoint from your server or with fetch, never from a public web page: that would expose your API token.

Authorizations

Authorization
string
header
required

Your CamposCloud API token, sent as Authorization: Bearer <token>.

Path Parameters

appId
string
required

ID of the application.

Pattern: ^[a-f0-9]{24}$

Query Parameters

tail
integer
default:100

How many recent lines to send before the live lines. Other query parameters are refused.

Required range: 0 <= x <= 500

Response

The stream. It stays open until the client disconnects or the server sends end.

The response is of type string.