Observability / Errors

List and search error logs for an environment

get

Returns paginated error log entries for a specific environment in a repository. Resolves the environment to its Salesforce org for querying. Supports predefined time ranges (last_1h through last_30d) or custom start/end dates. Full-text search across all error fields via the search parameter.

Authorizations

access-token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

repositoryIdentifierstringRequired

Repository identifier

Example: flxbl-io/sf-core

environmentNamestringRequired

Environment name

Example: prod

rangestring · enumOptional

Predefined time range. Ignored if start/end are provided.

Example: last_24hPossible values:

startstringOptional

Custom range start (ISO 8601). Requires end.

Example: 2026-01-15T00:00:00Z

endstringOptional

Custom range end (ISO 8601). Requires start.

Example: 2026-02-14T00:00:00Z

errorTypestring · enumOptional

Filter by error type

Possible values:

searchstringOptional

Full-text search across all error fields

Example: validation exception

limitnumberOptional

Maximum number of results (1-500)

Default: 50Example: 50

offsetnumberOptional

Pagination offset

Default: 0Example: 0

Responses

200

Error logs retrieved

application/json

403

Forbidden - Requires role: member, owner, application

get

/sfp/api/observability/errors

HTTPcURLJavaScriptPython

GET /sfp/api/observability/errors?repositoryIdentifier=flxbl-io%2Fsf-core&environmentName=prod HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "repositoryIdentifier": "flxbl-io/sf-core",
    "environmentName": "prod",
    "range": "last_24h",
    "start": "2026-02-13T10:30:00Z",
    "end": "2026-02-14T10:30:00Z",
    "generatedAt": "2026-02-14T10:30:00Z",
    "queryDurationMs": 42
  },
  "errors": [
    {
      "_time": "2026-02-14T10:30:00Z",
      "_msg": "Flow 'Lead_Assignment' failed at element 'Update_Records'",
      "error_type": "flow_failure",
      "org_id": "00D5g000004XXXX",
      "parse_status": "complete",
      "ingestion_path": "self_hosted",
      "flow_name": "Lead_Assignment",
      "failed_element": "Update_Records",
      "error_detail": "FIELD_CUSTOM_VALIDATION_EXCEPTION",
      "impacted_user": "[email protected]",
      "exception_type": "System.DmlException",
      "apex_class": "PaymentController",
      "apex_method": "processRefund",
      "stack_trace": "text",
      "exception_message": "text",
      "raw_subject": "text",
      "log_group": "error_logs"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  },
  "summary": {
    "total": 150,
    "byType": {
      "flow_failure": 100,
      "apex_exception": 50
    }
  }
}

Get repo-wide error summary across all environments

get

Returns aggregated error counts across all environments in a repository. Includes per-environment breakdown and time-series data. Useful for rendering overview dashboards. Supports predefined and custom date ranges.

Authorizations

access-token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

repositoryIdentifierstringRequired

Repository identifier

Example: flxbl-io/sf-core

rangestring · enumOptional

Predefined time range. Ignored if start/end are provided.

Example: last_24hPossible values:

startstringOptional

Custom range start (ISO 8601). Requires end.

Example: 2026-01-15T00:00:00Z

endstringOptional

Custom range end (ISO 8601). Requires start.

Example: 2026-02-14T00:00:00Z

Responses

200

Summary retrieved

application/json

totalnumberRequiredExample: 15

byTypeobjectRequiredExample: {"flow_failure":10,"apex_exception":5}

totalEnvironmentsnumberRequired

Total number of monitored environments in the repository

Example: 3

403

Forbidden - Requires role: member, owner, application

get

/sfp/api/observability/errors/summary

HTTPcURLJavaScriptPython

GET /sfp/api/observability/errors/summary?repositoryIdentifier=flxbl-io%2Fsf-core HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "repositoryIdentifier": "flxbl-io/sf-core",
    "environmentName": "prod",
    "range": "last_24h",
    "start": "2026-02-13T10:30:00Z",
    "end": "2026-02-14T10:30:00Z",
    "generatedAt": "2026-02-14T10:30:00Z",
    "queryDurationMs": 42
  },
  "environments": [
    {
      "environmentName": "prod",
      "orgId": "00D5g000004XXXX",
      "total": 15,
      "byType": {
        "flow_failure": 10,
        "apex_exception": 5
      }
    }
  ],
  "total": 15,
  "byType": {
    "flow_failure": 10,
    "apex_exception": 5
  },
  "timeSeries": [
    {
      "label": "flow_failure",
      "dataPoints": [
        {
          "timestamp": "2026-02-14T10:00:00Z",
          "count": 5
        }
      ]
    }
  ],
  "totalEnvironments": 3
}

Advanced raw LogsQL query

get

Execute a raw LogsQL query against VictoriaLogs. For power users and debugging.

Authorizations

access-token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

querystringRequired

LogsQL query string

Example: error_type:flow_failure AND org_id:00D5g000004XXXX

startstringOptional

Start time (ISO 8601 or relative like "1h")

Example: 2026-02-14T00:00:00Z

endstringOptional

End time (ISO 8601 or relative)

Example: 2026-02-14T23:59:59Z

limitnumberOptional

Maximum number of results to return

Example: 100

Responses

200

Query results

application/json

resultsstring[]Required

Array of log entries matching the query

403

Forbidden - Requires role: member, owner, application

get

/sfp/api/observability/errors/query

HTTPcURLJavaScriptPython

GET /sfp/api/observability/errors/query?query=error_type%3Aflow_failure+AND+org_id%3A00D5g000004XXXX HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "results": [
    "text"
  ]
}

Ingest pre-parsed error log entries

post

Ingest structured error log entries into VictoriaLogs. Used by programmatic integrations.

Authorizations

access-token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

201

Log entries ingested

application/json

400

Invalid request body

403

Forbidden - Requires role: member, application

post

/sfp/api/observability/errors/ingest

HTTPcURLJavaScriptPython

POST /sfp/api/observability/errors/ingest HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 371

{
  "entries": [
    {
      "_time": "2026-02-14T10:30:00Z",
      "_msg": "text",
      "error_type": "flow_failure",
      "org_id": "00D5g000004XXXX",
      "parse_status": "complete",
      "ingestion_path": "self_hosted",
      "flow_name": "text",
      "failed_element": "text",
      "error_detail": "text",
      "exception_type": "text",
      "apex_class": "text",
      "apex_method": "text",
      "stack_trace": "text",
      "exception_message": "text",
      "raw_subject": "text"
    }
  ]
}

{
  "written": 1,
  "parseStatus": "text",
  "message": "text"
}

Ingest raw Salesforce error email

post

Parse a raw Salesforce error email (Flow failure or Apex exception) and ingest into VictoriaLogs.

Authorizations

access-token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

subjectstringRequired

Email subject line

bodystringRequired

Email body content

orgIdstringOptional

Optional org ID override

Responses

201

Email parsed and ingested

application/json

400

Invalid request body

403

Forbidden - Requires role: member, application

post

/sfp/api/observability/errors/ingest/email

HTTPcURLJavaScriptPython

POST /sfp/api/observability/errors/ingest/email HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "subject": "text",
  "body": "text",
  "orgId": "text"
}

{
  "written": 1,
  "parseStatus": "text",
  "message": "text"
}