GET
activities/:id/versions/:version
Gets the details of the specified version of the Activity.
Resource Information
Method and URI | GET https://developer.api.autodesk.com/da/us-east/v3/activities/:id/versions/:version |
Authentication Context | app only |
Required OAuth Scopes | code:all |
Data Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via OAuth |
* Required
Request
URI Parameters
id string | Name of Activity (unqualified). |
version int | Version to retrieve (integer). |
Response
HTTP Status Code Summary
200 OK | Successfully get the details of an Activity’s version. |
403 Forbidden | Unauthorized |
404 Not Found | Could not find the item. |
500 Internal Server Error | Internal error. |
Response
Body Structure (200)
Expand all
commandLine array: string | Path to Engine executable with arguments. Activity command line. | ||||||
parameters object | Each parameter represents an input or output file. Named parameters of an Activity have corresponding named arguments of a WorkItem. | ||||||
* object | Type: dictionary<string, *> | ||||||
zip boolean | This attribute together with the XrefTreeArgumentBase.PathInZip attribute determine how zip files are handled. Default is false. For onDemand=’true’ the Zip file is just downloaded, not unzipped. | ||||||
localName string | Provides default name of the file or folder on the processing server for this parameter. Note this name may be overriden in various ways. | ||||||
ondemand boolean | The parameter will be accessed by the appbundle on demand and should not be used by the system. Default is false.
When onDemand=’true’, the next parameter’s ‘verb’s only valid values are get or head . | ||||||
verb enum:string | Defines the operation for a parameter. get, put, post, patch imply an HTTP operation on the url in the parameter. read implies that the string value of parameter should be read. get and read imply input parameters all others are output.
Possible values: get , head , put , post , patch , read | ||||||
description string | The description of the parameter. | ||||||
required boolean | Specifies whether the corresponding WorkItem Argument is required. Default is false. | ||||||
id string | Name of Activity, see the example section. | ||||||
engine string | The actual processing engine that runs the WorkItem job and processes the Activity. | ||||||
appbundles array: string | A module referenced by an Activity in order to perform specific functions. Typically this is a DLL or some other form of custom code. | ||||||
settings object | The url/string Settings for a given set of AppBundles. | ||||||
* any of | Type: dictionary<string, *> | ||||||
StringSetting object | |||||||
value string | |||||||
isEnvironmentVariable boolean | |||||||
UrlSetting object | |||||||
url string | Url. | ||||||
headers object | Headers. | ||||||
* string | Type: dictionary<string, *> | ||||||
verb enum:string | Defines the operation for a parameter. get, put, post, patch imply an HTTP operation on the url in the parameter. read implies that the string value of parameter should be read. get and read imply input parameters all others are output.
Possible values: get , head , put , post , patch , read | ||||||
multiparts object | Provide multipart post method to upload the results and multiparts can be empty if there is no “parameter” to provide.
It supports Box, Google Drive and Amazon Simple Storage Service (S3) services. Examples of using argument “multiparts”: Box:
Google Drive:
Amazon Simple Storage Service (S3):
| ||||||
* object | Type: dictionary<string, *> | ||||||
description string | Human readable description of the object. | ||||||
version int | The verison retrieved. |
Example
Successfully get the details of an Activity’s version.
Request
curl -v 'https://developer.api.autodesk.com/da/us-east/v3/activities/:id/versions/:version' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
Response
{
"commandLine": [
"$(engine.path)\\InventorCoreConsole.exe /i \"$(args[InventorDoc].path)\" /al \"$(appbundles[ChangeParams].path)\" \"$(args[InventorParams].path)\""
],
"parameters": {
"InventorDoc": {
"verb": "get"
},
"InventorParams": {
"localName": "params.json",
"verb": "get"
},
"OutputIpt": {
"localName": "Result.ipt",
"verb": "post"
},
"OutputIam": {
"localName": "Result.zip",
"verb": "post"
},
"OutputBmp": {
"localName": "Result.bmp",
"verb": "post"
}
},
"id": "SampleActivity",
"engine": "Autodesk.Inventor+23",
"appbundles": [
"owner.ChangeParams+prod"
],
"description": "Human readable description of the object.",
"version": 1
}
Show More