Question answers

Create Question Answer

Creates a question-answer.

POST
/question-answers.create

Authorization

AuthorizationBearer <token>

All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request. How do I find my token?

In: header

Request Body

access_level?access-level
Value in"external" | "internal" | "private" | "public" | "restricted"
answerstring

Answer of the question-answer.

Formattext
applies_to_articles?array<string>

The articles that the question-answer applies to.

applies_to_partsarray<string>

The parts that the question-answer applies to.

Items1 <= items
owned_byarray<string>

The users that own the question-answer.

questionstring

Question of the question-answer.

Formattext
shared_with?array<set-shared-with-membership>

Information about the role the member receives due to the share.

sources?array<string>

The source of the question-answer.

statusquestion-answer-status

Status of the question answer.

Value in"archived" | "discarded" | "draft" | "published" | "review_needed"
suggested_answer?string

Alternative answer for the question-answer sugested by Q/A Discovery.

Formattext
suggested_for_deletion?boolean

Whether the question-answer was suggeste to be deleted by Q/A Discovery.

tags?array<set-tag-with-value>

Tags associated with the question-answer.

topic?string

Topic of the question-answer.

Formattext
verified?boolean

Whether the question-answer was verified by a user or not.

Response Body

curl -X POST "https://api.devrev.ai/question-answers.create" \  -H "Content-Type: application/json" \  -d '{    "answer": "string",    "applies_to_parts": [      "PROD-12345"    ],    "owned_by": [      "DEVU-12345"    ],    "question": "string",    "status": "archived"  }'
{
  "question_answer": {
    "created_by": {
      "type": "dev_user",
      "display_id": "string",
      "id": "string",
      "display_name": "string",
      "display_picture": {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      },
      "email": "string",
      "full_name": "string",
      "state": "active"
    },
    "created_date": "2023-01-01T12:00:00.000Z",
    "display_id": "string",
    "id": "string",
    "modified_by": {
      "type": "dev_user",
      "display_id": "string",
      "id": "string",
      "display_name": "string",
      "display_picture": {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      },
      "email": "string",
      "full_name": "string",
      "state": "active"
    },
    "modified_date": "2023-01-01T12:00:00.000Z",
    "answer": "string",
    "applies_to_parts": [
      {
        "type": "capability",
        "display_id": "string",
        "id": "string",
        "name": "string",
        "owned_by": [
          {
            "type": "dev_user",
            "display_id": "string",
            "id": "string",
            "display_name": "string",
            "display_picture": {
              "display_id": "string",
              "id": "string",
              "file": {
                "type": "string",
                "name": "string",
                "size": 0
              }
            },
            "email": "string",
            "full_name": "string",
            "state": "active"
          }
        ],
        "sync_metadata": {
          "external_reference": "string",
          "origin_system": "string"
        }
      }
    ],
    "question": "string",
    "sources": [
      {
        "type": "account",
        "display_id": "string",
        "id": "string",
        "display_name": "string"
      }
    ],
    "status": "archived",
    "suggested_answer": "string",
    "suggested_for_deletion": true,
    "topic": "string",
    "verified": true
  }
}
{
  "detail": "string",
  "message": "string",
  "type": "artifact_already_attached_to_a_parent",
  "existing_parent": "string",
  "is_same": true
}
{
  "detail": "string",
  "message": "string",
  "type": "unauthenticated"
}
{
  "detail": "string",
  "message": "string",
  "type": "forbidden"
}
{
  "detail": "string",
  "message": "string",
  "type": "too_many_requests",
  "retry_after": 0
}
{
  "detail": "string",
  "message": "string",
  "type": "internal_error",
  "reference_id": "string"
}
{
  "detail": "string",
  "message": "string",
  "type": "service_unavailable"
}