Endpoints - Get

Get the service endpoint details.

GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?api-version=7.1
GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?actionFilter={actionFilter}&api-version=7.1

URI Parameters

Name In Required Type Description
endpointId
path True

string

uuid

Id of the service endpoint.

organization
path True

string

The name of the Azure DevOps organization.

project
path True

string

Project ID or project name

api-version
query True

string

Version of the API to use. This should be set to '7.1' to use this version of the api.

actionFilter
query

ServiceEndpointActionFilter

Action filter for the service connection. It specifies the action which can be performed on the service connection.

Responses

Name Type Description
200 OK

ServiceEndpoint

successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name Description
vso.serviceendpoint Grants the ability to read service endpoints.

Examples

Get service endpoint details

Sample request

GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?api-version=7.1

Sample response

{
  "data": {},
  "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
  "name": "MyNewServiceEndpoint",
  "type": "Generic",
  "url": "https://myserver",
  "createdBy": {
    "displayName": "Chuck Reinhart",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
      }
    },
    "id": "e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
    "uniqueName": "fabfiber@outlook.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
    "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
  },
  "description": "",
  "authorization": {
    "parameters": {
      "username": "myusername",
      "password": null
    },
    "scheme": "UsernamePassword"
  },
  "isShared": false,
  "isReady": true,
  "owner": "Library",
  "serviceEndpointProjectReferences": [
    {
      "projectReference": {
        "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
        "name": "TestProject"
      },
      "name": "MyNewServiceEndpoint"
    }
  ]
}

Definitions

Name Description
EndpointAuthorization

Represents the authorization used for service endpoint.

IdentityRef
JObject

Represents a JSON object.

JToken

Represents an abstract JSON token.

ProjectReference
ReferenceLinks

The class to represent a collection of REST reference links.

ServiceEndpoint

Represents an endpoint which may be used by an orchestration job.

ServiceEndpointActionFilter

Action filter for the service connection. It specifies the action which can be performed on the service connection.

ServiceEndpointProjectReference

EndpointAuthorization

Represents the authorization used for service endpoint.

Name Type Description
parameters

object

Gets or sets the parameters for the selected authorization scheme.

scheme

string

Gets or sets the scheme used for service endpoint authentication.

IdentityRef

Name Type Description
_links

ReferenceLinks

This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject.

descriptor

string

The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.

directoryAlias

string

Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary

displayName

string

This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.

id

string

imageUrl

string

Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary

inactive

boolean

Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary

isAadIdentity

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Deprecated - not in use in most preexisting implementations of ToIdentityRef

uniqueName

string

Deprecated - use Domain+PrincipalName instead

url

string

This url is the full route to the source resource of this graph subject.

JObject

Represents a JSON object.

Name Type Description
item

JToken

Represents an abstract JSON token.

type

string

Gets the node type for this JToken.

JToken

Represents an abstract JSON token.

Name Type Description
first

JToken

Get the first child token of this token.

hasValues

boolean

Gets a value indicating whether this token has child tokens.

item

JToken

Represents an abstract JSON token.

last

JToken

Get the last child token of this token.

next

JToken

Gets the next sibling token of this node.

parent

string

Gets or sets the parent.

path

string

Gets the path of the JSON token.

previous

JToken

Gets the previous sibling token of this node.

root

JToken

Gets the root JToken of this JToken.

type

string

Gets the node type for this JToken.

ProjectReference

Name Type Description
id

string

name

string

The class to represent a collection of REST reference links.

Name Type Description
links

object

The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

ServiceEndpoint

Represents an endpoint which may be used by an orchestration job.

Name Type Description
administratorsGroup

IdentityRef

This is a deprecated field.

authorization

EndpointAuthorization

Gets or sets the authorization data for talking to the endpoint.

createdBy

IdentityRef

Gets or sets the identity reference for the user who created the Service endpoint.

data

object

description

string

Gets or sets the description of endpoint.

groupScopeId

string

This is a deprecated field.

id

string

Gets or sets the identifier of this endpoint.

isReady

boolean

EndPoint state indicator

isShared

boolean

Indicates whether service endpoint is shared with other projects or not.

name

string

Gets or sets the friendly name of the endpoint.

operationStatus

JObject

Error message during creation/deletion of endpoint

owner

string

Owner of the endpoint Supported values are "library", "agentcloud"

readersGroup

IdentityRef

Gets or sets the identity reference for the readers group of the service endpoint.

serviceEndpointProjectReferences

ServiceEndpointProjectReference[]

All other project references where the service endpoint is shared.

type

string

Gets or sets the type of the endpoint.

url

string

Gets or sets the url of the endpoint.

ServiceEndpointActionFilter

Action filter for the service connection. It specifies the action which can be performed on the service connection.

Name Type Description
manage

string

none

string

use

string

view

string

ServiceEndpointProjectReference

Name Type Description
description

string

Gets or sets description of the service endpoint.

name

string

Gets or sets name of the service endpoint.

projectReference

ProjectReference

Gets or sets project reference of the service endpoint.