Articles

Update Article

Updates an article.

POST
/articles.update

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"
aliases?articles-update-request-aliases
applies_to_parts?articles-update-request-applies-to-parts
artifacts?articles-update-request-artifacts
authored_by?articles-update-request-authored-by
brand?string | null

The updated brand of the article.

Formatid
content_blocks?articles-update-request-content-blocks
content_format?article-content-format

Content format of the article.

Value in"drdfv2" | "rt"
custom_fields?object

Application-defined custom fields.

Empty Object

custom_schema_spec?custom-schema-spec

Custom schemas described using identifiers. Each custom field in the request must have the corresponding schema specified; omission results in a Bad Request error. If a custom schema is not included in the specifier, it remains unchanged. For surfaces with human interactors, it is recommended to provide tenant_fragment: true and validate_required_fields: true.

data_sources?articles-update-request-article-data-source-update
description?string

Updated description of the article object, or unchanged if not provided.

Formattext
extracted_content?articles-update-request-extracted-content
idstring

The article's ID.

Formatid
language?string

Updates the language of the article.

Formattext
notify?boolean

Whether to notify the users when the article is published.

owned_by?articles-update-request-owned-by
parent?string | null

The updated parent directory for the article.

Formatid
published_version?string

Updates the the latest published version.

Formattext
release_notes?string

Updates the release notes of the article.

Formattext
reorder?articles-update-request-reorder
shared_with?articles-update-request-shared-with
status?article-status

Status of the article.

Value in"archived" | "draft" | "published" | "review_needed"
tags?articles-update-request-tags
title?string

Updated title of the article object, or unchanged if not provided.

Formattext
url?string

Updates the URL of the external article.

Formattext

Response Body

curl -X POST "https://api.devrev.ai/articles.update" \  -H "Content-Type: application/json" \  -d '{    "id": "ARTICLE-12345"  }'
{
  "article": {
    "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",
    "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"
          }
        ]
      }
    ],
    "article_type": "article",
    "authored_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"
      }
    ],
    "description": "string",
    "extracted_content": [
      {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      }
    ],
    "num_downvotes": 0,
    "num_upvotes": 0,
    "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"
      }
    ],
    "parent": {
      "display_id": "string",
      "id": "string"
    },
    "rank": "string",
    "resource": {
      "artifacts": [
        {
          "display_id": "string",
          "id": "string",
          "file": {
            "type": "string",
            "name": "string",
            "size": 0
          }
        }
      ],
      "url": "string"
    },
    "scope": {
      "id": 0,
      "label": "string",
      "ordinal": 0,
      "value": null
    },
    "title": "string"
  }
}
{
  "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": "not_found"
}
{
  "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"
}

List Articles GET

Previous Page

Get Atom (POST) POST

Next Page