Upload file (attachment)

Upload a file as a work item attachment via the generic request endpoint. The request body is the file (binary); the response includes an attachment ID and URL. Use that URL when adding the attachment as a link to a work item (e.g. with the "Add link to existing work item" example). Replace the Body path with your file path and set your organization and project in the URL.

Standard SQL query example

This is the base query accepted by the connector. To execute it in SQL Server, you have to pass it to the Data Gateway via a Linked Server. See how to accomplish this using the examples below.

SELECT *
FROM generic_request
WITH(
	  Url='YOUR_ORGANIZATION/YOUR_PROJECT/_apis/wit/attachments?api-version=7.0',
	  RequestMethod='POST',
	  RequestContentTypeCode='ApplicationOctetStream', --//Binary upload
	  --Headers='Content-Type: application/octet-stream', --//same as above
	  Body='@c:\temp\screenshot-1.png',
	  IsMultiPart=1,
	  Meta='id:string(100);url:string(500)' --response columns you like to display
)

Using OPENQUERY in SQL Server

SELECT * FROM OPENQUERY([LS_TO_AZURE_DEVOPS_IN_GATEWAY], 'SELECT *
FROM generic_request
WITH(
	  Url=''YOUR_ORGANIZATION/YOUR_PROJECT/_apis/wit/attachments?api-version=7.0'',
	  RequestMethod=''POST'',
	  RequestContentTypeCode=''ApplicationOctetStream'', --//Binary upload
	  --Headers=''Content-Type: application/octet-stream'', --//same as above
	  Body=''@c:\temp\screenshot-1.png'',
	  IsMultiPart=1,
	  Meta=''id:string(100);url:string(500)'' --response columns you like to display
)')

Using EXEC in SQL Server (handling larger SQL text)

The major drawback of OPENQUERY is its inability to incorporate variables within SQL statements. This often leads to the use of cumbersome dynamic SQL (with numerous ticks and escape characters).

Fortunately, starting with SQL 2005 and onwards, you can utilize the EXEC (your_sql) AT [LS_TO_AZURE_DEVOPS_IN_GATEWAY] syntax.

DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT *
FROM generic_request
WITH(
	  Url=''YOUR_ORGANIZATION/YOUR_PROJECT/_apis/wit/attachments?api-version=7.0'',
	  RequestMethod=''POST'',
	  RequestContentTypeCode=''ApplicationOctetStream'', --//Binary upload
	  --Headers=''Content-Type: application/octet-stream'', --//same as above
	  Body=''@c:\temp\screenshot-1.png'',
	  IsMultiPart=1,
	  Meta=''id:string(100);url:string(500)'' --response columns you like to display
)'
EXEC (@MyQuery) AT [LS_TO_AZURE_DEVOPS_IN_GATEWAY]