Home
/
API reference
/
API documentation (JSON/XML)
/
Tasks
/
Object user assignment tasks

Object user assignement task

API reference (XML/JSON) · Updated 2023-09-18

Function

The ObjectUserAssignement task assigns to a user an object of another user in whose administration it is. Possible objects are domains, zones, domain contacts, pre-registrations, redirects, BackupMX and TMCH.

Description

Route: PUT /object/_assignment

Route Bulk: PATCH /bulk/objectUserAssignment

{
	"type": "domain",
	"name": "example.de",
	"owner": {
		"user": "newowner",
		"context": "4"
	}
}

{
  "stid": "20211104-app-80335",
  "status" : {
    "code" : "S1308",
    "text" : "The object user assignment was changed successfully.",
    "type" : "SUCCESS"
  },
  "object" : {
    "type" : "domain",
    "value" : "example.de",
    "data" : {
      "type" : "domain",
      "name" : "example.de"
    }
  }
}

{
    "template": {
        "type": "domain",
        "owner": {
            "user": "customer",
            "context": 4
        }
    },
    "objects": [
        {
            "name": "example.de"
        },
        {
            "name": "example.com"
        }
     ]
}

{
    "stid": "20211104-app-9152",
    "object": {
        "type": "ObjectUserAssignment",
        "summary": 1
    },
    "data": [
        {
            "status": {
                "code": "S1308",
                "text": "The object user assignment was changed successfully.",
                "type": "SUCCESS"
            },
            "object": {
                "type": "domain",
                "value": "example.de",
                "data": {
                    "type": "domain",
                    "name": "example.de"
                }
            }
        },
        {
            "status": {
                "code": "S1308",
                "text": "OThe object user assignment was changed successfully.",
                "type": "SUCCESS"
            },
            "object": {
                "type": "domain",
                "value": "example.com",
                "data": {
                    "type": "domain",
                    "name": "example.com"
                }
            }
        }     
    ]
}

Task code: 1308
Uses ObjectUserAssignment object

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>1308</code>
		<object>
			<type>handle</type>
			<name>239272</name>
			<owner>
				<user>newuser</user>
				<context>4</context>
			</owner>
		</object>
		<reply_to>EMAIL</reply_to>
		<cancelation>assign</cancelation>
	</task>
</request>

<response>
    <result>
        <data/>
        <status>
            <code>S1308</code>
            <text>The object user assignment was changed successfully.</text>
            <type>success</type>
            <object>
                <type>handle</type>
                <value>239272</value>
            </object>
        </status>
    </result>
    <stid>20211104-app-80532</stid>
</response>