Azure DevOps

Azure DevOps Wikis API

Operations for managing wiki instances

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /wiki/wikis List wikis in a project · Azure DevOps List wikis #
Ask an LLM
“What wikis does my Azure DevOps project have?”
“Are there code wikis in the project besides the project wiki?”
Tell an agent
List the wikis in the project.
Show every project and code wiki, using API version {apiVersion}.
POST /wiki/wikis Create a wiki · Azure DevOps Create a wiki #
Ask an LLM
“How do I publish a folder from a repo as a code wiki?”
“Can I create a project wiki for a project that has none?”
Tell an agent
Create a {type} wiki named {name} in project {projectId}.
Create {type} wiki {name} in {projectId} from repository {repositoryId} at path {mappedPath}.
GET /wiki/wikis/{wikiIdentifier} Get a wiki · Azure DevOps Get a wiki #
Ask an LLM
“Which repository and mapped path back a given wiki?”
“Can I look up one wiki by its name?”
Tell an agent
Show wiki {wikiIdentifier}.
Get the backing repository of wiki {wikiIdentifier}.
PATCH /wiki/wikis/{wikiIdentifier} Change a code wiki's branch · Azure DevOps Update a wiki #
Ask an LLM
“How do I point a code wiki at a renamed main branch?”
“Can I change which branch versions a code wiki publishes?”
Tell an agent
Set the versions of wiki {wikiIdentifier} to {versions}.
Switch code wiki {wikiIdentifier} to branch {versions}.
DELETE /wiki/wikis/{wikiIdentifier} Delete a wiki · Azure DevOps Delete a wiki #
Ask an LLM
“Does deleting a project wiki also delete its Git repository?”
“Can I unpublish a code wiki without losing the repository?”
Tell an agent destructive · confirm first
Delete wiki {wikiIdentifier}.
Unpublish code wiki {wikiIdentifier}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/
📖
Authentication
https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/authentication-guidance
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/git/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/build/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/release/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/test/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/artifacts/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/hooks/
📖
Documentation
https://learn.microsoft.com/en-us/rest/api/azure/devops/wiki/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-devops/refs/heads/main/openapi/microsoft-azure-devops-wikis-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-devops/refs/heads/main/asyncapi/azure-devops-service-hooks-asyncapi.yml

Other Resources

🔗
Client Libraries
https://learn.microsoft.com/en-us/azure/devops/integrate/concepts/dotnet-client-libraries?view=azure-devops
🔗
Reference
https://learn.microsoft.com/en-us/azure/devops/service-hooks/overview?view=azure-devops

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/microsoft-azure-devops:microsoft-azure-devops-wikis-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-devops-wikis-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure DevOps Wiki Wikis API
  description: REST API for creating and managing wikis and wiki pages in Azure DevOps projects. Every project wiki is backed by a Git repository, enabling version-controlled documentation. Supports creating, reading, updating, and deleting wikis and pages programmatically with Markdown content.
  version: '7.1'
  contact:
    name: Microsoft Azure DevOps
    url: https://learn.microsoft.com/en-us/rest/api/azure/devops/wiki/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://dev.azure.com/{organization}/{project}/_apis
  description: Azure DevOps Wiki API
  variables:
    organization:
      description: Azure DevOps organization name or ID
      default: myorganization
    project:
      description: Azure DevOps project name or ID
      default: myproject
security:
- bearerAuth: []
- basicAuth: []
tags:
- name: Wikis
  description: Operations for managing wiki instances
paths:
  /wiki/wikis:
    get:
      operationId: wikis_list
      summary: Azure DevOps List wikis
      description: Returns a list of all wikis in the project. A project typically has one project wiki and may have additional code wikis that are backed by specific Git repository folders.
      tags:
      - Wikis
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: List of wikis returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: Number of wikis returned
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/WikiV2'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
    post:
      operationId: wikis_create
      summary: Azure DevOps Create a wiki
      description: Creates a new wiki for a project. You can create a project wiki (backed by a dedicated wiki repository) or a code wiki (backed by an existing Git repository and folder path). Only one project wiki can exist per project.
      tags:
      - Wikis
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        description: Wiki creation parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WikiCreateParametersV2'
            example:
              name: Project Wiki
              type: projectWiki
              projectId: a1b2c3d4-e5f6-a1b2-c3d4-e5f6a1b2c3d4
      responses:
        '200':
          description: Wiki created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WikiV2'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
  /wiki/wikis/{wikiIdentifier}:
    get:
      operationId: wikis_get
      summary: Azure DevOps Get a wiki
      description: Returns detailed information about a specific wiki, including its backing Git repository ID, mapped path (for code wikis), and current version. The wikiIdentifier can be either the wiki GUID or its name.
      tags:
      - Wikis
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/WikiIdentifier'
      - name: versionDescriptor
        in: query
        required: false
        description: Version descriptor for the wiki (branch or tag)
        schema:
          type: string
      responses:
        '200':
          description: Wiki returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WikiV2'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    patch:
      operationId: wikis_update
      summary: Azure DevOps Update a wiki
      description: Updates the wiki by changing the default branch for a code wiki's backed repository. This is useful when the main branch of the backing repository has been renamed.
      tags:
      - Wikis
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/WikiIdentifier'
      requestBody:
        required: true
        description: Wiki update parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WikiUpdateParameters'
            example:
              versions:
              - version: main
      responses:
        '200':
          description: Wiki updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WikiV2'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      operationId: wikis_delete
      summary: Azure DevOps Delete a wiki
      description: Deletes a wiki. For a project wiki, this deletes the wiki and the backing Git repository. For a code wiki, this removes the wiki but leaves the backing repository intact. This operation cannot be undone.
      tags:
      - Wikis
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/WikiIdentifier'
      responses:
        '200':
          description: Wiki deleted successfully, returns the deleted wiki
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WikiV2'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    WikiIdentifier:
      name: wikiIdentifier
      in: path
      required: true
      description: Wiki GUID or wiki name
      schema:
        type: string
    ApiVersion:
      name: api-version
      in: query
      required: true
      description: Azure DevOps REST API version. Use 7.1 for the latest stable version.
      schema:
        type: string
        default: '7.1'
        enum:
        - '7.1'
        - '7.0'
        - '6.0'
  responses:
    Unauthorized:
      description: Unauthorized - missing or invalid authentication credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Not found - the requested resource does not exist
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Forbidden:
      description: Forbidden - insufficient permissions to perform this operation
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    BadRequest:
      description: Bad request - invalid parameters or request body
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  schemas:
    ApiError:
      type: object
      description: Error response from the Azure DevOps API
      properties:
        id:
          type: string
          format: uuid
        message:
          type: string
        typeName:
          type: string
        typeKey:
          type: string
        errorCode:
          type: integer
        eventId:
          type: integer
    WikiCreateParametersV2:
      type: object
      description: Parameters for creating a new wiki
      required:
      - name
      - type
      - projectId
      properties:
        name:
          type: string
          description: Name of the wiki
          example: Project Wiki
        type:
          type: string
          description: Type of wiki to create
          enum:
          - projectWiki
          - codeWiki
        projectId:
          type: string
          format: uuid
          description: ID of the project to create the wiki in
        repositoryId:
          type: string
          format: uuid
          description: ID of the repository to back the wiki (required for codeWiki)
        mappedPath:
          type: string
          description: Root folder in the repository to use as wiki content (for codeWiki)
          example: /docs
        version:
          type: object
          description: Branch to use for the wiki
          properties:
            version:
              type: string
              description: Branch name
              example: main
    WikiV2:
      type: object
      description: An Azure DevOps wiki
      properties:
        id:
          type: string
          format: uuid
          description: Unique GUID identifier of the wiki
        name:
          type: string
          description: Display name of the wiki
          example: Project Wiki
        type:
          type: string
          description: Type of wiki
          enum:
          - projectWiki
          - codeWiki
        projectId:
          type: string
          format: uuid
          description: ID of the project this wiki belongs to
        repositoryId:
          type: string
          format: uuid
          description: ID of the backing Git repository
        mappedPath:
          type: string
          description: Root folder path in the repository (for code wikis)
          example: /wiki
        versions:
          type: array
          description: Branches or versions available for this wiki
          items:
            type: object
            properties:
              version:
                type: string
                description: Branch name
                example: main
        url:
          type: string
          format: uri
          description: URL to access this wiki via the REST API
        remoteUrl:
          type: string
          format: uri
          description: Clone URL for the backing repository
        _links:
          type: object
          additionalProperties:
            type: object
            properties:
              href:
                type: string
                format: uri
    WikiUpdateParameters:
      type: object
      description: Parameters for updating a wiki
      properties:
        versions:
          type: array
          description: Updated branch list for this wiki
          items:
            type: object
            properties:
              version:
                type: string
                description: Branch name
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Azure AD OAuth 2.0 bearer token
    basicAuth:
      type: http
      scheme: basic
      description: Basic authentication using a Personal Access Token (PAT). Use any string as the username and the PAT as the password, then base64-encode the result.