Decline an agent recommendation

Close the recommendation and decline its help center drafts. The agent does not propose the same change again.

POST

/api/v2/agent/recommendations/{id}/decline

POST

/agent/recommendations/{id}/decline

curl -X POST "https://productlane.com/api/v2/agent/recommendations/{id}/decline" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

id
string
path
required

Body

application/json

reason
string

Response

application/json

Successful response

id
string
required
type
enum<string>
required
docs: a missing help center article. contradiction: articles that disagree. guidance: a rule for the agent's guidance. connector: data or an action the agent needs from your systems; accepting it files a Linear issue.
One of:
docs
contradiction
guidance
connector
status
enum<string>
required
expired: closed by the agent after its conversations went quiet.
One of:
open
accepted
declined
expired
title
string
required
summary
string
required
conversation_count
integer
required
impact_per_month
integer
required
Conversations per month the agent is expected to resolve once accepted.
thread_ids
string[]
required
examples
object[]
required
guidance
object | null
required
The guidance before and after the change. Set on guidance recommendations.
docs_draft_ids
string[]
required
Help center drafts this recommendation applies. Read them with GET /docs/drafts/{id}.
connector
object | null
required
What the agent needs connected. Set on connector recommendations.
linear_issue
object | null
required
decline_reason
string | null
required
created_at
string
required
updated_at
string
required

{
  "id": "string",
  "type": "docs",
  "status": "open",
  "title": "string",
  "summary": "string",
  "conversation_count": 0,
  "impact_per_month": 0,
  "thread_ids": [
    "string"
  ],
  "examples": [
    {
      "thread_id": "string",
      "question": "string"
    }
  ],
  "guidance": {
    "before": "string",
    "after": "string"
  },
  "docs_draft_ids": [
    "string"
  ],
  "connector": {
    "need": "string",
    "suggestion": "string",
    "system": "string"
  },
  "linear_issue": {
    "id": "string",
    "identifier": "string",
    "url": "string"
  },
  "decline_reason": "string",
  "created_at": "string",
  "updated_at": "string"
}

POST

/agent/recommendations/{id}/decline

curl -X POST "https://productlane.com/api/v2/agent/recommendations/{id}/decline" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

{
  "id": "string",
  "type": "docs",
  "status": "open",
  "title": "string",
  "summary": "string",
  "conversation_count": 0,
  "impact_per_month": 0,
  "thread_ids": [
    "string"
  ],
  "examples": [
    {
      "thread_id": "string",
      "question": "string"
    }
  ],
  "guidance": {
    "before": "string",
    "after": "string"
  },
  "docs_draft_ids": [
    "string"
  ],
  "connector": {
    "need": "string",
    "suggestion": "string",
    "system": "string"
  },
  "linear_issue": {
    "id": "string",
    "identifier": "string",
    "url": "string"
  },
  "decline_reason": "string",
  "created_at": "string",
  "updated_at": "string"
}

- Introduction
- Authentication
- MCP Server
- Errors
- Rate limits
- Pagination
- Article content
- Webhooks
- Migrating from API v1 to v2

APIAgent

Decline an agent recommendation

Close the recommendation and decline its help center drafts. The agent does not propose the same change again.

POST

/api/v2/agent/recommendations/{id}/decline

POST

/agent/recommendations/{id}/decline

curl -X POST "https://productlane.com/api/v2/agent/recommendations/{id}/decline" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

id
string
path
required

Body

application/json

reason
string

Response

application/json

Successful response

id
string
required
type
enum<string>
required
docs: a missing help center article. contradiction: articles that disagree. guidance: a rule for the agent's guidance. connector: data or an action the agent needs from your systems; accepting it files a Linear issue.
One of:
docs
contradiction
guidance
connector
status
enum<string>
required
expired: closed by the agent after its conversations went quiet.
One of:
open
accepted
declined
expired
title
string
required
summary
string
required
conversation_count
integer
required
impact_per_month
integer
required
Conversations per month the agent is expected to resolve once accepted.
thread_ids
string[]
required
examples
object[]
required
guidance
object | null
required
The guidance before and after the change. Set on guidance recommendations.
docs_draft_ids
string[]
required
Help center drafts this recommendation applies. Read them with GET /docs/drafts/{id}.
connector
object | null
required
What the agent needs connected. Set on connector recommendations.
linear_issue
object | null
required
decline_reason
string | null
required
created_at
string
required
updated_at
string
required

{
  "id": "string",
  "type": "docs",
  "status": "open",
  "title": "string",
  "summary": "string",
  "conversation_count": 0,
  "impact_per_month": 0,
  "thread_ids": [
    "string"
  ],
  "examples": [
    {
      "thread_id": "string",
      "question": "string"
    }
  ],
  "guidance": {
    "before": "string",
    "after": "string"
  },
  "docs_draft_ids": [
    "string"
  ],
  "connector": {
    "need": "string",
    "suggestion": "string",
    "system": "string"
  },
  "linear_issue": {
    "id": "string",
    "identifier": "string",
    "url": "string"
  },
  "decline_reason": "string",
  "created_at": "string",
  "updated_at": "string"
}

POST

/agent/recommendations/{id}/decline

curl -X POST "https://productlane.com/api/v2/agent/recommendations/{id}/decline" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

{
  "id": "string",
  "type": "docs",
  "status": "open",
  "title": "string",
  "summary": "string",
  "conversation_count": 0,
  "impact_per_month": 0,
  "thread_ids": [
    "string"
  ],
  "examples": [
    {
      "thread_id": "string",
      "question": "string"
    }
  ],
  "guidance": {
    "before": "string",
    "after": "string"
  },
  "docs_draft_ids": [
    "string"
  ],
  "connector": {
    "need": "string",
    "suggestion": "string",
    "system": "string"
  },
  "linear_issue": {
    "id": "string",
    "identifier": "string",
    "url": "string"
  },
  "decline_reason": "string",
  "created_at": "string",
  "updated_at": "string"
}