Signals

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

PATCH
DELETE
GET
POST
POST
POST
GET
POST
POST
DELETE
GET
GET
POST
PATCH
DELETE
POST
DELETE

Update signals reports

Edit the human-facing title and/or summary (description) of a signal report, addressed by id. Both fields are optional — supply only the ones you want to change; at least one is required. Every other report field (status, weights, judgments) is managed by the signals pipeline and cannot be set here. Returns the full updated report.

Required API key scopes

inbox:writetask:write

Path parameters

  • id
    string

Request parameters

  • title
    string
  • summary
    string

Response


Example request

PATCH /api/projects/:project_id/signals/reports/:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X PATCH \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/\
-d title="string"

Example response

Status 200 Report updated.
RESPONSE
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"summary": "string",
"summary_lead": "string",
"reviewer_assignment": {
"state": {
"reviewers_id": "2e0d6f9a-f7b9-4851-80c4-2938b51252f8",
"corrections_id": "d6237cc9-ee4f-4270-9a15-7e959436f098"
},
"pinned_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"excluded_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"confirmed": true,
"needs_review": true,
"enabled": true
},
"status": "potential",
"monitoring_started_at": "2019-08-24T14:15:22Z",
"monitoring_ended_at": "2019-08-24T14:15:22Z",
"total_weight": 0.1,
"signal_count": 0,
"signals_at_run": 0,
"collapsed_note_count": 0,
"startup_failure": {
"provider": "claude",
"phase": "session_setup",
"reason": "string",
"retryability": "requires_action",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"message": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"artefact_count": 0,
"charts": [
{
"chart_id": "string",
"title": "string",
"query": null,
"caption": "string",
"size": "small"
}
],
"metrics": [
{
"metric_id": "string",
"title": "string",
"kind": "affected_users",
"role": "supporting",
"value": 0,
"value_at": "2019-08-24T14:15:22Z",
"series": [
0.1
],
"series_buckets": [
"string"
],
"value_format": "number",
"unit": "string",
"query": null,
"caption": "string",
"goal_value": 0,
"goal_direction": "at_most",
"goal_grain": "whole_window",
"decision_window_days": 1,
"minimum_data_points": 1
}
],
"suggested_prompts": [
"string"
],
"tags": [
"string"
],
"source_suggestion": {
"product": "logs",
"reason": "string"
},
"priority": "string",
"actionability": "string",
"already_addressed": true,
"decisions": {
"repository": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"priority": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "P0"
},
"actionability": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"already_addressed": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": true
}
},
"dismissal_reason": "string",
"dismissal_note": "string",
"suppression_source": "dismissed",
"suppression_explanation": "string",
"repo_slug": "string",
"is_self_improvement_report": true,
"research_context": {
"mode": "code",
"repository_status": "available"
},
"is_suggested_reviewer": false,
"source_products": [
"string"
],
"scout_name": "string",
"implementation_pr_url": "string",
"pull_requests": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"url": "http://example.com",
"state": "unknown",
"merged": true,
"review_decision": "approved",
"merged_at": "2019-08-24T14:15:22Z",
"attached_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"attached_at": "2019-08-24T14:15:22Z"
}
],
"implementation_pr_state": "unknown",
"implementation_pr_merged": true,
"tracker_issue_url": "string",
"tracker_issue_reference": "string",
"tracker_issue_error": "string",
"source_issues": [
"string"
],
"work_state": "unclaimed",
"assignee": {
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"agent": "string",
"claimed_at": "2019-08-24T14:15:22Z",
"responsible_user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
}
},
"implementation_in_flight": true,
"refund": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"reason": "pr_incorrect",
"note": "string",
"billing_path": "excluded",
"credits": 0,
"pr_url": "string",
"pr_run_created_at": "2019-08-24T14:15:22Z",
"credit_amount_usd": "string",
"billing_synced": true,
"created_at": "2019-08-24T14:15:22Z"
},
"refund_ineligibility_reason": "already_refunded",
"billing_exempt_reason": "posthog_health_check",
"channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
"ranking": {
"status": "scored",
"model": "string",
"scored_at": "2019-08-24T14:15:22Z",
"predictions": [
{
"outcome": "open",
"probability": 0.1,
"lift": 0,
"readable": true
}
]
},
"plan": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"steps": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"depends_on": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"implementation_pr_url": "string",
"implementation_pr_state": "unknown",
"suppression_source": "dismissed"
}
]
}
}
Status 400 Neither title nor summary supplied, or a value failed validation.
Status 404 Report not found for this project.

Delete signals reports

Soft-delete a report and its signals via the deletion workflow.

Required API key scopes

inbox:write

Path parameters

  • id
    string

Response


Example request

DELETE /api/projects/:project_id/signals/reports/:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X DELETE \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/

Example response

Status 200 A deletion is already running.
RESPONSE
{
"status": "deletion_started",
"report_id": "5ed7905a-4735-4cf7-b1ab-521e066fb971"
}
Status 202 Deletion started.
RESPONSE
{
"status": "deletion_started",
"report_id": "5ed7905a-4735-4cf7-b1ab-521e066fb971"
}

List all signals reports actions

List the actions on this report that start an agent run, read from the report's current state. get_it_merged is available only while the report has an open, approved pull request. make_it_green is available only while CI fails on the report's open pull request, or while it conflicts with its base branch. resolve_conflicts is available only while the report's open pull request conflicts with its base branch. implement is available only while the report is ready and actionable, or waiting on input, has no pull request, is not a plan, has no implementation run in progress, and nobody else holds its claim. suggested_prompt has one entry per prompt the report suggests. Start one with the run endpoint.

Required API key scopes

inbox:read

Path parameters

  • id
    string

Response


Example request

GET /api/projects/:project_id/signals/reports/:id/actions
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/actions/

Example response

Status 200
RESPONSE
{
"results": [
{
"action": "get_it_merged",
"available": true,
"disabled_reason": "string",
"suggested_prompt_index": 0,
"text": "string"
}
]
}

Create signals reports actions run

Create a task linked to the report and start its first run in the background, with the instructions the inbox uses for the same action. ask sends your own message with the framing of the inbox's Ask AI. implement starts the run the inbox's Implement button starts: it claims the report, and the pull request it opens is attached to the report. The run shows in the report's runs and counts toward the report's task limit. Nobody can answer questions in a background run, so the agent writes a note to the report's work log when it needs a decision. A task sandbox cannot start an action, except a scout run that a person granted the action in the scout's settings.

Required API key scopes

inbox:writetask:write

Path parameters

  • id
    string

Request parameters

  • action
  • suggested_prompt_index
    integer
  • message
    string
  • repository
    string

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/actions/run
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/actions/run/\
-d action=undefined

Example response

Status 201 Task created
RESPONSE
{
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"task_url": "string",
"run_error": "string"
}
Status 400 The action is not available on this report now (code `report_action_unavailable`), the `repository` is not connected to this project (code `report_action_repository_unavailable`), or no repository could be resolved for `implement` (code `report_implementation_repository_unresolved`)
RESPONSE
{
"code": "string",
"detail": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"
}
Status 402 The organization is on a Self-driving free trial (code `self_driving_free_trial`)
RESPONSE
{
"code": "string",
"detail": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"
}
Status 403 AI data processing is not approved, the request came from a task sandbox, or `implement` needs code access the caller does not have. A sandbox that is not a scout run gets `report_action_sandbox_refused`. A scout run that was not granted the action gets `report_action_not_granted`, and `get_it_merged` always does.
RESPONSE
{
"code": "string",
"detail": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"
}
Status 404 The report has no suggested prompt at that index
Status 409 A run is already working on this report's pull request, or for `implement`, an implementation run is still in progress (code `report_action_run_active`). The body carries its `task_id` and `run_id` once that run has started.
RESPONSE
{
"code": "string",
"detail": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"
}
Status 429 The report reached its task limit (code `signal_report_task_cap`), the per-user creation limit fired (code `throttled`), a scout reached its daily report action cap (code `report_action_scout_daily_cap`), or the organization reached its usage limit or is deactivated
RESPONSE
{
"code": "string",
"detail": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec"
}

Create signals reports

Start or update work for the current user, internal task, or external agent. Supply claim_id to resume, pull_requests to add PRs, takeover=true to explicitly take ownership, or release=true to end ownership while preserving work history and PR links. Adding PRs needs task:write as well as inbox:write.

Required API key scopes

inbox:write

Path parameters

  • id
    string

Request parameters

  • claim_id
    string
  • pull_requests
    array
  • takeover
    boolean
    Default: false
  • takeover_claim_id
    string
  • pr_url
    string
  • release
    boolean
    Default: false

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/claim
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/claim/\
-d claim_id="string"

Example response

Status 200 Current report and assignment.
RESPONSE
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"summary": "string",
"summary_lead": "string",
"reviewer_assignment": {
"state": {
"reviewers_id": "2e0d6f9a-f7b9-4851-80c4-2938b51252f8",
"corrections_id": "d6237cc9-ee4f-4270-9a15-7e959436f098"
},
"pinned_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"excluded_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"confirmed": true,
"needs_review": true,
"enabled": true
},
"status": "potential",
"monitoring_started_at": "2019-08-24T14:15:22Z",
"monitoring_ended_at": "2019-08-24T14:15:22Z",
"total_weight": 0.1,
"signal_count": 0,
"signals_at_run": 0,
"collapsed_note_count": 0,
"startup_failure": {
"provider": "claude",
"phase": "session_setup",
"reason": "string",
"retryability": "requires_action",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"message": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"artefact_count": 0,
"charts": [
{
"chart_id": "string",
"title": "string",
"query": null,
"caption": "string",
"size": "small"
}
],
"metrics": [
{
"metric_id": "string",
"title": "string",
"kind": "affected_users",
"role": "supporting",
"value": 0,
"value_at": "2019-08-24T14:15:22Z",
"series": [
0.1
],
"series_buckets": [
"string"
],
"value_format": "number",
"unit": "string",
"query": null,
"caption": "string",
"goal_value": 0,
"goal_direction": "at_most",
"goal_grain": "whole_window",
"decision_window_days": 1,
"minimum_data_points": 1
}
],
"suggested_prompts": [
"string"
],
"tags": [
"string"
],
"source_suggestion": {
"product": "logs",
"reason": "string"
},
"priority": "string",
"actionability": "string",
"already_addressed": true,
"decisions": {
"repository": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"priority": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "P0"
},
"actionability": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"already_addressed": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": true
}
},
"dismissal_reason": "string",
"dismissal_note": "string",
"suppression_source": "dismissed",
"suppression_explanation": "string",
"repo_slug": "string",
"is_self_improvement_report": true,
"research_context": {
"mode": "code",
"repository_status": "available"
},
"is_suggested_reviewer": false,
"source_products": [
"string"
],
"scout_name": "string",
"implementation_pr_url": "string",
"pull_requests": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"url": "http://example.com",
"state": "unknown",
"merged": true,
"review_decision": "approved",
"merged_at": "2019-08-24T14:15:22Z",
"attached_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"attached_at": "2019-08-24T14:15:22Z"
}
],
"implementation_pr_state": "unknown",
"implementation_pr_merged": true,
"tracker_issue_url": "string",
"tracker_issue_reference": "string",
"tracker_issue_error": "string",
"source_issues": [
"string"
],
"work_state": "unclaimed",
"assignee": {
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"agent": "string",
"claimed_at": "2019-08-24T14:15:22Z",
"responsible_user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
}
},
"implementation_in_flight": true,
"refund": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"reason": "pr_incorrect",
"note": "string",
"billing_path": "excluded",
"credits": 0,
"pr_url": "string",
"pr_run_created_at": "2019-08-24T14:15:22Z",
"credit_amount_usd": "string",
"billing_synced": true,
"created_at": "2019-08-24T14:15:22Z"
},
"refund_ineligibility_reason": "already_refunded",
"billing_exempt_reason": "posthog_health_check",
"channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
"ranking": {
"status": "scored",
"model": "string",
"scored_at": "2019-08-24T14:15:22Z",
"predictions": [
{
"outcome": "open",
"probability": 0.1,
"lift": 0,
"readable": true
}
]
},
"plan": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"steps": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"depends_on": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"implementation_pr_url": "string",
"implementation_pr_state": "unknown",
"suppression_source": "dismissed"
}
]
}
}
Status 400 The pull request URL or request shape is invalid.
Status 409 The report cannot be claimed or released in its current state, or another person holds the claim and the takeover has no takeover_claim_id.

Create signals reports feedback

Record the thumbs rating at the end of a report, with an optional note. For browser-session requests the rating is persisted as a per-person report action, which counts as consumption evidence for the scout that authored the report (scouts whose output nobody consumes are eventually paused); requests authenticated any other way record no action. When a note is present and the report was authored by a scout, the note is also forwarded to that scout as a steering note it reads on its next run; for any other report there is nothing to steer. The report's state is never changed.

Required API key scopes

inbox:read

Path parameters

  • id
    string

Request parameters

  • sentiment
  • note
    string
    Default:

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/feedback
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/feedback/\
-d sentiment=undefined

Example response

Status 200
RESPONSE
{
"forwarded": true
}

Retrieve signals reports feedback state

Required API key scopes

inbox:read

Path parameters

  • id
    string

Response


Example request

GET /api/projects/:project_id/signals/reports/:id/feedback_state
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/feedback_state/

Example response

Status 200
RESPONSE
{
"sentiment": "positive",
"note": "string"
}

Create signals reports merge

Fold one or more duplicate reports into this report, which survives. The sources' signals, work-log artefacts, pull requests, task runs and checks move onto the survivor, the survivor's signal counters take on theirs, and each source is archived with a 'duplicate of' link back to the survivor. A source's open pull request stays open, because the survivor holds it after the move. Pick the survivor deliberately: prefer the older report, and prefer the one with an open implementation PR or an active claim. Any active claim on a source is released, so re-claim the survivor if you were working on one. Titles and summaries are not combined, so edit it afterwards if it needs a rewrite. A merged report keeps its URL but cannot be restored, because its signals now belong to the survivor.

Required API key scopes

inbox:write

Path parameters

  • id
    string

Request parameters

  • source_report_ids
    array
  • reason
    string

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/merge
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/merge/\
-d source_report_ids="array"

Example response

Status 200 The surviving report after the merge, plus one result per merged source.
RESPONSE
{
"report": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"summary": "string",
"summary_lead": "string",
"reviewer_assignment": {
"state": {
"reviewers_id": "2e0d6f9a-f7b9-4851-80c4-2938b51252f8",
"corrections_id": "d6237cc9-ee4f-4270-9a15-7e959436f098"
},
"pinned_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"excluded_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"confirmed": true,
"needs_review": true,
"enabled": true
},
"status": "potential",
"monitoring_started_at": "2019-08-24T14:15:22Z",
"monitoring_ended_at": "2019-08-24T14:15:22Z",
"total_weight": 0.1,
"signal_count": 0,
"signals_at_run": 0,
"collapsed_note_count": 0,
"startup_failure": {
"provider": "claude",
"phase": "session_setup",
"reason": "string",
"retryability": "requires_action",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"message": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"artefact_count": 0,
"charts": [
{
"chart_id": "string",
"title": "string",
"query": null,
"caption": "string",
"size": "small"
}
],
"metrics": [
{
"metric_id": "string",
"title": "string",
"kind": "affected_users",
"role": "supporting",
"value": 0,
"value_at": "2019-08-24T14:15:22Z",
"series": [
0.1
],
"series_buckets": [
"string"
],
"value_format": "number",
"unit": "string",
"query": null,
"caption": "string",
"goal_value": 0,
"goal_direction": "at_most",
"goal_grain": "whole_window",
"decision_window_days": 1,
"minimum_data_points": 1
}
],
"suggested_prompts": [
"string"
],
"tags": [
"string"
],
"source_suggestion": {
"product": "logs",
"reason": "string"
},
"priority": "string",
"actionability": "string",
"already_addressed": true,
"decisions": {
"repository": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"priority": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "P0"
},
"actionability": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"already_addressed": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": true
}
},
"dismissal_reason": "string",
"dismissal_note": "string",
"suppression_source": "dismissed",
"suppression_explanation": "string",
"repo_slug": "string",
"is_self_improvement_report": true,
"research_context": {
"mode": "code",
"repository_status": "available"
},
"is_suggested_reviewer": false,
"source_products": [
"string"
],
"scout_name": "string",
"implementation_pr_url": "string",
"pull_requests": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"url": "http://example.com",
"state": "unknown",
"merged": true,
"review_decision": "approved",
"merged_at": "2019-08-24T14:15:22Z",
"attached_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"attached_at": "2019-08-24T14:15:22Z"
}
],
"implementation_pr_state": "unknown",
"implementation_pr_merged": true,
"tracker_issue_url": "string",
"tracker_issue_reference": "string",
"tracker_issue_error": "string",
"source_issues": [
"string"
],
"work_state": "unclaimed",
"assignee": {
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"agent": "string",
"claimed_at": "2019-08-24T14:15:22Z",
"responsible_user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
}
},
"implementation_in_flight": true,
"refund": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"reason": "pr_incorrect",
"note": "string",
"billing_path": "excluded",
"credits": 0,
"pr_url": "string",
"pr_run_created_at": "2019-08-24T14:15:22Z",
"credit_amount_usd": "string",
"billing_synced": true,
"created_at": "2019-08-24T14:15:22Z"
},
"refund_ineligibility_reason": "already_refunded",
"billing_exempt_reason": "posthog_health_check",
"channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
"ranking": {
"status": "scored",
"model": "string",
"scored_at": "2019-08-24T14:15:22Z",
"predictions": [
{
"outcome": "open",
"probability": 0.1,
"lift": 0,
"readable": true
}
]
},
"plan": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"steps": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"depends_on": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"implementation_pr_url": "string",
"implementation_pr_state": "unknown",
"suppression_source": "dismissed"
}
]
}
},
"sources": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"artefacts_moved": 0,
"signals_moved": 0,
"released_claim": true
}
]
}
Status 404 The surviving report was not found in this project.
Status 409 Both ends of a merge must be a live report of this project. Returned when the survivor is resolved, or when a source is the survivor itself, is resolved or archived, is still being researched, carries more signals than one merge can move, or belongs to another project. Nothing is applied.

Create signals reports plan steps

Link an existing report to this report as a plan step, with part_of. A report becomes a plan when it gets its first step. The step goes last in plan order. When the step is already resolved or archived and every other step is too, the plan closes the same way a plan closes when its last step does.

Required API key scopes

inbox:write

Path parameters

  • id
    string

Request parameters

  • report_id
    string
  • depends_on
    array
  • reason
    string

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/plan_steps
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/plan_steps/\
-d report_id="string"

Example response

Status 200 The plan report, with the new step in `plan.steps`.
RESPONSE
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"summary": "string",
"summary_lead": "string",
"reviewer_assignment": {
"state": {
"reviewers_id": "2e0d6f9a-f7b9-4851-80c4-2938b51252f8",
"corrections_id": "d6237cc9-ee4f-4270-9a15-7e959436f098"
},
"pinned_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"excluded_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"confirmed": true,
"needs_review": true,
"enabled": true
},
"status": "potential",
"monitoring_started_at": "2019-08-24T14:15:22Z",
"monitoring_ended_at": "2019-08-24T14:15:22Z",
"total_weight": 0.1,
"signal_count": 0,
"signals_at_run": 0,
"collapsed_note_count": 0,
"startup_failure": {
"provider": "claude",
"phase": "session_setup",
"reason": "string",
"retryability": "requires_action",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"message": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"artefact_count": 0,
"charts": [
{
"chart_id": "string",
"title": "string",
"query": null,
"caption": "string",
"size": "small"
}
],
"metrics": [
{
"metric_id": "string",
"title": "string",
"kind": "affected_users",
"role": "supporting",
"value": 0,
"value_at": "2019-08-24T14:15:22Z",
"series": [
0.1
],
"series_buckets": [
"string"
],
"value_format": "number",
"unit": "string",
"query": null,
"caption": "string",
"goal_value": 0,
"goal_direction": "at_most",
"goal_grain": "whole_window",
"decision_window_days": 1,
"minimum_data_points": 1
}
],
"suggested_prompts": [
"string"
],
"tags": [
"string"
],
"source_suggestion": {
"product": "logs",
"reason": "string"
},
"priority": "string",
"actionability": "string",
"already_addressed": true,
"decisions": {
"repository": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"priority": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "P0"
},
"actionability": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"already_addressed": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": true
}
},
"dismissal_reason": "string",
"dismissal_note": "string",
"suppression_source": "dismissed",
"suppression_explanation": "string",
"repo_slug": "string",
"is_self_improvement_report": true,
"research_context": {
"mode": "code",
"repository_status": "available"
},
"is_suggested_reviewer": false,
"source_products": [
"string"
],
"scout_name": "string",
"implementation_pr_url": "string",
"pull_requests": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"url": "http://example.com",
"state": "unknown",
"merged": true,
"review_decision": "approved",
"merged_at": "2019-08-24T14:15:22Z",
"attached_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"attached_at": "2019-08-24T14:15:22Z"
}
],
"implementation_pr_state": "unknown",
"implementation_pr_merged": true,
"tracker_issue_url": "string",
"tracker_issue_reference": "string",
"tracker_issue_error": "string",
"source_issues": [
"string"
],
"work_state": "unclaimed",
"assignee": {
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"agent": "string",
"claimed_at": "2019-08-24T14:15:22Z",
"responsible_user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
}
},
"implementation_in_flight": true,
"refund": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"reason": "pr_incorrect",
"note": "string",
"billing_path": "excluded",
"credits": 0,
"pr_url": "string",
"pr_run_created_at": "2019-08-24T14:15:22Z",
"credit_amount_usd": "string",
"billing_synced": true,
"created_at": "2019-08-24T14:15:22Z"
},
"refund_ineligibility_reason": "already_refunded",
"billing_exempt_reason": "posthog_health_check",
"channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
"ranking": {
"status": "scored",
"model": "string",
"scored_at": "2019-08-24T14:15:22Z",
"predictions": [
{
"outcome": "open",
"probability": 0.1,
"lift": 0,
"readable": true
}
]
},
"plan": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"steps": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"depends_on": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"implementation_pr_url": "string",
"implementation_pr_state": "unknown",
"suppression_source": "dismissed"
}
]
}
}
Status 400 The edit breaks a link rule: the step is the plan itself or a report not found in this project, a `depends_on` id is not another step of this plan, or a link would close a cycle. `error` names the rule.
Status 404 The plan report was not found in this project.
Status 409 The report is already a step of this plan or of another plan.

Delete signals reports plan steps

Remove the step's part_of link to this plan, and every depends_on link between the step and the plan's other steps. The step report keeps its status, pull requests and claim. A note on the step and on the plan records the removal. When every step left is resolved or archived, the plan closes.

Required API key scopes

inbox:write

Path parameters

  • id
    string
  • step_id
    string

Query parameters

  • reason
    string

Response


Example request

DELETE /api/projects/:project_id/signals/reports/:id/plan_steps/:step_id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X DELETE \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/plan_steps/:step_id/

Example response

Status 200 The plan report, without the step in `plan.steps`.
RESPONSE
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"summary": "string",
"summary_lead": "string",
"reviewer_assignment": {
"state": {
"reviewers_id": "2e0d6f9a-f7b9-4851-80c4-2938b51252f8",
"corrections_id": "d6237cc9-ee4f-4270-9a15-7e959436f098"
},
"pinned_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"excluded_user_uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"confirmed": true,
"needs_review": true,
"enabled": true
},
"status": "potential",
"monitoring_started_at": "2019-08-24T14:15:22Z",
"monitoring_ended_at": "2019-08-24T14:15:22Z",
"total_weight": 0.1,
"signal_count": 0,
"signals_at_run": 0,
"collapsed_note_count": 0,
"startup_failure": {
"provider": "claude",
"phase": "session_setup",
"reason": "string",
"retryability": "requires_action",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",
"message": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"artefact_count": 0,
"charts": [
{
"chart_id": "string",
"title": "string",
"query": null,
"caption": "string",
"size": "small"
}
],
"metrics": [
{
"metric_id": "string",
"title": "string",
"kind": "affected_users",
"role": "supporting",
"value": 0,
"value_at": "2019-08-24T14:15:22Z",
"series": [
0.1
],
"series_buckets": [
"string"
],
"value_format": "number",
"unit": "string",
"query": null,
"caption": "string",
"goal_value": 0,
"goal_direction": "at_most",
"goal_grain": "whole_window",
"decision_window_days": 1,
"minimum_data_points": 1
}
],
"suggested_prompts": [
"string"
],
"tags": [
"string"
],
"source_suggestion": {
"product": "logs",
"reason": "string"
},
"priority": "string",
"actionability": "string",
"already_addressed": true,
"decisions": {
"repository": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"priority": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "P0"
},
"actionability": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"already_addressed": {
"reason": "string",
"set_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"set_at": "2019-08-24T14:15:22Z",
"value": true
}
},
"dismissal_reason": "string",
"dismissal_note": "string",
"suppression_source": "dismissed",
"suppression_explanation": "string",
"repo_slug": "string",
"is_self_improvement_report": true,
"research_context": {
"mode": "code",
"repository_status": "available"
},
"is_suggested_reviewer": false,
"source_products": [
"string"
],
"scout_name": "string",
"implementation_pr_url": "string",
"pull_requests": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"url": "http://example.com",
"state": "unknown",
"merged": true,
"review_decision": "approved",
"merged_at": "2019-08-24T14:15:22Z",
"attached_by": {
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"agent": "string",
"task_id": "736fde4d-9029-4915-8189-01353d6982cb"
},
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"attached_at": "2019-08-24T14:15:22Z"
}
],
"implementation_pr_state": "unknown",
"implementation_pr_merged": true,
"tracker_issue_url": "string",
"tracker_issue_reference": "string",
"tracker_issue_error": "string",
"source_issues": [
"string"
],
"work_state": "unclaimed",
"assignee": {
"claim_id": "6ed32748-64af-4d95-94ea-a78b6397033c",
"kind": "user",
"user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"task_id": "736fde4d-9029-4915-8189-01353d6982cb",
"agent": "string",
"claimed_at": "2019-08-24T14:15:22Z",
"responsible_user": {
"id": 0,
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
}
},
"implementation_in_flight": true,
"refund": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"reason": "pr_incorrect",
"note": "string",
"billing_path": "excluded",
"credits": 0,
"pr_url": "string",
"pr_run_created_at": "2019-08-24T14:15:22Z",
"credit_amount_usd": "string",
"billing_synced": true,
"created_at": "2019-08-24T14:15:22Z"
},
"refund_ineligibility_reason": "already_refunded",
"billing_exempt_reason": "posthog_health_check",
"channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
"ranking": {
"status": "scored",
"model": "string",
"scored_at": "2019-08-24T14:15:22Z",
"predictions": [
{
"outcome": "open",
"probability": 0.1,
"lift": 0,
"readable": true
}
]
},
"plan": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"steps": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"title": "string",
"status": "potential",
"depends_on": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"implementation_pr_url": "string",
"implementation_pr_state": "unknown",
"suppression_source": "dismissed"
}
]
}
}
Status 400 The edit breaks a link rule: the step is the plan itself or a report not found in this project, a `depends_on` id is not another step of this plan, or a link would close a cycle. `error` names the rule.
Status 404 The plan report was not found in this project.
Status 409 The report is not a step of this plan.

Retrieve signals report pr

Fetch the CI status (GitHub Actions check runs and legacy commit statuses) of the pull request attached to the report, via the team's GitHub integration.

Required API key scopes

inbox:read

Path parameters

  • id
    string

Query parameters

  • pull_request_id
    string

Response


Example request

GET /api/projects/:project_id/signals/reports/:id/pr_checks
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_checks/

Example response

Status 200 The CI checks on the report's implementation pull request.
RESPONSE
{
"checks": [
{
"name": "string",
"status": "string",
"conclusion": "string",
"url": "string"
}
],
"has_conflict": true
}
Status 403 GitHub is connected without permission to read pull request checks (code `github_checks_permission_missing`), or the GitHub App installation is suspended or uninstalled (code `github_installation_unavailable`). Both carry a `remediation_url`.
RESPONSE
{
"code": "string",
"error": "string",
"remediation_url": "string"
}
Status 404 Report has no implementation PR, or no GitHub integration can access it (code `github_repository_inaccessible`, with a `remediation_url`).
Status 502 GitHub could not return the checks.
Status 503 The GitHub egress budget is temporarily unavailable.

Retrieve signals report pr

Fetch the pull request's conversation comments and inline review comments, merged chronologically, via the team's GitHub integration.

Required API key scopes

inbox:read

Path parameters

  • id
    string

Query parameters

  • pull_request_id
    string

Response


Example request

GET /api/projects/:project_id/signals/reports/:id/pr_comments
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_comments/

Example response

Status 200 Conversation and review comments on the report's implementation pull request.
RESPONSE
{
"comments": [
{
"id": "string",
"author": "string",
"author_avatar_url": "string",
"body": "string",
"created_at": "string",
"url": "string",
"comment_type": "conversation",
"path": "string",
"line": 0,
"start_line": 0,
"side": "LEFT",
"diff_hunk": "string",
"in_reply_to_id": "string",
"commit_id": "string",
"reactions": [
{
"id": "string",
"content": "string",
"user_login": "string"
}
]
}
]
}
Status 403 The GitHub App installation is suspended or uninstalled (code `github_installation_unavailable`).
RESPONSE
{
"code": "string",
"error": "string",
"remediation_url": "string"
}
Status 404 Report has no implementation PR, or no GitHub integration can access it (code `github_repository_inaccessible`, with a `remediation_url`).
Status 502 GitHub could not return the comments.
Status 503 The GitHub egress budget is temporarily unavailable.

Create signals report pr review comments

Post an inline review comment on the report's implementation pull request, attributed to the requesting user's own GitHub identity via their personal GitHub connection. Either replies to an existing thread (in_reply_to) or starts a new thread on a diff line (path + line).

Required API key scopes

inbox:write

Path parameters

  • id
    string

Query parameters

  • pull_request_id
    string

Request parameters

  • body
    string
  • in_reply_to
    string | null
  • path
    string | null
  • line
    integer | null
  • side

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/pr_review_comments
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_review_comments/\
-d body="string"

Example response

Status 201 The created review comment, in the normalized PR-comment shape.
RESPONSE
{
"comment": {
"id": "string",
"author": "string",
"author_avatar_url": "string",
"body": "string",
"created_at": "string",
"url": "string",
"comment_type": "conversation",
"path": "string",
"line": 0,
"start_line": 0,
"side": "LEFT",
"diff_hunk": "string",
"in_reply_to_id": "string",
"commit_id": "string",
"reactions": [
{
"id": "string",
"content": "string",
"user_login": "string"
}
]
}
}
Status 400 Invalid comment payload.
Status 403 Not a signed-in user, or the requesting user has no usable personal GitHub connection (reconnect GitHub).
Status 404 Report has no implementation PR, or no GitHub integration can access it.
Status 502 GitHub rejected the comment.
Status 503 The GitHub egress budget is temporarily unavailable.

Update signals report pr review comment

Required API key scopes

inbox:write

Path parameters

  • comment_id
    string
  • id
    string

Query parameters

  • pull_request_id
    string

Request parameters

  • body
    string

Response


Example request

PATCH /api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X PATCH \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/\
-d body="string"

Example response

Status 200 The edited review comment, in the normalized PR-comment shape.
RESPONSE
{
"comment": {
"id": "string",
"author": "string",
"author_avatar_url": "string",
"body": "string",
"created_at": "string",
"url": "string",
"comment_type": "conversation",
"path": "string",
"line": 0,
"start_line": 0,
"side": "LEFT",
"diff_hunk": "string",
"in_reply_to_id": "string",
"commit_id": "string",
"reactions": [
{
"id": "string",
"content": "string",
"user_login": "string"
}
]
}
}
Status 403 Not a signed-in user, no usable personal GitHub connection, or not the comment's author.
Status 404 Report has no implementation PR, or the comment isn't on it.
Status 502 GitHub rejected the edit.
Status 503 The GitHub egress budget is temporarily unavailable.

Delete signals report pr review comment

Required API key scopes

inbox:write

Path parameters

  • comment_id
    string
  • id
    string

Query parameters

  • pull_request_id
    string

Example request

DELETE /api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X DELETE \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/

Example response

Status 204 Comment deleted.
Status 403 Not a signed-in user, no usable personal GitHub connection, or not the comment's author.
Status 404 Report has no implementation PR, or the comment isn't on it.
Status 502 GitHub rejected the delete.
Status 503 The GitHub egress budget is temporarily unavailable.

Create signals report pr review comment reactions

Required API key scopes

inbox:write

Path parameters

  • comment_id
    string
  • id
    string

Query parameters

  • pull_request_id
    string

Request parameters

  • content

Response


Example request

POST /api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/reactions
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl
-H 'Content-Type: application/json'\
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/reactions/\
-d content=undefined

Example response

Status 201 The created reaction.
RESPONSE
{
"reaction": {
"id": "string",
"content": "string",
"user_login": "string"
}
}
Status 403 Not a signed-in user, or no usable personal GitHub connection.
Status 404 Report has no implementation PR, or the comment isn't on it.
Status 502 GitHub rejected the reaction.
Status 503 The GitHub egress budget is temporarily unavailable.

Delete signals report pr review comment reaction

Required API key scopes

inbox:write

Path parameters

  • comment_id
    string
  • id
    string
  • reaction_id
    string

Query parameters

  • pull_request_id
    string

Example request

DELETE /api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/reactions/:reaction_id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X DELETE \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
<ph_app_host>/api/projects/:project_id/signals/reports/:id/pr_review_comments/:comment_id/reactions/:reaction_id/

Example response

Status 204 Reaction removed.
Status 403 Not a signed-in user, or no usable personal GitHub connection.
Status 404 Report has no implementation PR, or the comment isn't on it.
Status 502 GitHub rejected the removal.
Status 503 The GitHub egress budget is temporarily unavailable.